Pixfaro
Genera imágenes con todos los modelos principales — Nano Banana, Gemini, GPT Image — desde un solo MCP; una clave de API, un saldo prepagado, sin suscripción.
Documentación
Pixfaro MCP — servidor MCP de generación de imágenes para cada modelo de imágenes
Una conexión MCP, un saldo prepagado, cada modelo de imágenes importante — Nano Banana,
Gemini hoy, GPT Image próximamente (visible como "próximamente" en list_models).
Pixfaro gestiona las cuentas de los proveedores, claves, reintentos y diferencias de formato;
tu agente solo pide una imagen.
Funciona con Claude Desktop, Claude Code, Cursor, Windsurf y cualquier cliente MCP.
Inicio rápido — sin necesidad de terminal (≈1 minuto)
El servidor remoto es la ruta más fácil: pega una URL, inicia sesión con tu cuenta de Pixfaro en la ventana del navegador que se abre. Sin clave API en ningún archivo.
Claude (claude.ai / Claude Desktop, cualquier plan): Configuración → Conectores →
Agregar conector personalizado → URL https://mcp.pixfaro.com/mcp → inicia sesión.
(Team/Enterprise: un propietario de la organización lo agrega una vez en Configuración de la organización →
Conectores → Personalizado → Web.)
Cursor: Agregar a Cursor →
— o Configuración de Cursor → MCP → Agregar nuevo servidor MCP (tipo URL, dirección
https://mcp.pixfaro.com/mcp); Cursor ejecuta el flujo OAuth por sí mismo.
ChatGPT (Pro/Plus/Business/Edu): Configuración → habilitar modo Desarrollador
(los conectores viven en Plugins desde el cambio de nombre de julio de 2026, anteriormente
Conectores → Avanzado) → agrega un conector personalizado con URL
https://mcp.pixfaro.com/mcp, OAuth.
Inicio rápido — línea de comandos / archivo de configuración
- Obtén una clave API en pixfaro.com y recarga saldo (sin suscripción).
- Agrega el servidor a la configuración de tu cliente MCP:
{
"mcpServers": {
"pixfaro": {
"command": "npx",
"args": ["-y", "@pixfaro/mcp"],
"env": { "PIXFARO_KEY": "pf_live_…" }
}
}
}
- Pide una imagen a tu agente. Eso es todo.
Para Claude Code:
claude mcp add pixfaro -e PIXFARO_KEY=pf_live_… -- npx -y @pixfaro/mcp
Los clientes que hablan HTTP transmisible también pueden usar la forma remota en el mismo archivo — sin clave, OAuth en el primer uso:
{ "mcpServers": { "pixfaro": { "url": "https://mcp.pixfaro.com/mcp" } } }
``` Clients
without OAuth can pass an API key instead: `Authorization: Bearer pf_live_…`.
## Tools
| Tool | What it does |
|---|---|
| `generate_image` | prompt → hosted image URL (+cost and balance in the reply) |
| `edit_image` | natural-language edit of a previous generation by its `img_…` id |
| `list_models` | models with price, latency, and what each is best for |
| `render_template` | typeset card (quote/post) from a template — $0.02, ~2 s, sharp type · *remote server; npx parity coming in 0.2* |
| `list_templates` | card templates with slots, style axes and exact prices · *remote server* |
| `upload_asset` | upload a PNG/JPEG (≤5 MB) as a reusable asset (e.g. a card avatar) · *remote server* |
| `get_balance` | current prepaid balance |
Replies carry a hosted URL, never base64 — your agent's context stays small.
Both generation tools accept `aspect_ratio` (e.g. `"16:9"`, `"9:16"`). Edits
keep the source image's shape when you omit it — pass one only to reshape.
## CLI
The same package family ships an unscoped CLI for scripts, CI, and pipelines:
```bash
export PIXFARO_KEY=pf_live_…
npx pixfaro gen "a lighthouse at night, minimal flat style" -a 16:9 -o cover.png
npx pixfaro models
npx pixfaro balance
npx pixfaro edit img_8f2a… "make the sky darker" -o v2.png
Entorno
| Variable | Significado |
|---|---|
PIXFARO_KEY | tu clave API (pf_live_…) — requerida para todo excepto models |
PIXFARO_API_URL | anulación de endpoint (por defecto https://api.pixfaro.com) |
Qué es este repositorio
El cliente abierto y ligero sobre la API de Pixfaro: el servidor MCP (@pixfaro/mcp) y
el CLI pixfaro comparten un cliente HTTP. La capa de saldo/proveedor vive
detrás de api.pixfaro.com — este código es intencionalmente
lo suficientemente pequeño para leerlo antes de entregarle una clave.
MIT © Pixfaro