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

  1. Obtén una clave API en pixfaro.com y recarga saldo (sin suscripción).
  2. Agrega el servidor a la configuración de tu cliente MCP:
{
  "mcpServers": {
    "pixfaro": {
      "command": "npx",
      "args": ["-y", "@pixfaro/mcp"],
      "env": { "PIXFARO_KEY": "pf_live_…" }
    }
  }
}
  1. 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

VariableSignificado
PIXFARO_KEYtu clave API (pf_live_…) — requerida para todo excepto models
PIXFARO_API_URLanulació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