Pixfaro

Pixfaro MCP — servidor MCP de geração de imagens para todos os modelos de imagem

Uma conexão MCP, um saldo pré-pago, todos os principais modelos de imagem — Nano Banana, Gemini hoje, GPT Image em seguida (visível como "em breve" em list_models). A Pixfaro mantém as contas dos provedores, chaves, tentativas e diferenças de formato; seu agente apenas pede uma imagem.

Funciona com Claude Desktop, Claude Code, Cursor, Windsurf e qualquer cliente MCP.

Início rápido — sem necessidade de terminal (≈1 minuto)

O servidor remoto é o caminho mais fácil: cole uma URL, faça login com sua conta Pixfaro na janela do navegador que abrir. Nenhuma chave de API em arquivo algum.

Claude (claude.ai / Claude Desktop, qualquer plano): Configurações → Conectores → Adicionar conector personalizado → URL https://mcp.pixfaro.com/mcp → faça login. (Equipe/Empresa: um proprietário da organização adiciona uma vez em Configurações da organização → Conectores → Personalizado → Web.)

Cursor: Adicionar ao Cursor → — ou Configurações do Cursor → MCP → Adicionar novo servidor MCP (tipo URL, endereço https://mcp.pixfaro.com/mcp); o Cursor executa o fluxo OAuth por conta própria.

ChatGPT (Pro/Plus/Business/Edu): Configurações → ative o Modo desenvolvedor (conectores ficam em Plugins desde a renomeação de julho de 2026, anteriormente Conectores → Avançado) → adicione um conector personalizado com URL https://mcp.pixfaro.com/mcp, OAuth.

Início rápido — linha de comando / arquivo de configuração

1. Obtenha uma chave de API em pixfaro.com e faça uma recarga (sem assinatura).
2. Adicione o servidor à configuração do seu cliente MCP:

{
  "mcpServers": {
    "pixfaro": {
      "command": "npx",
      "args": ["-y", "@pixfaro/mcp"],
      "env": { "PIXFARO_KEY": "pf_live_…" }
    }
  }
}

3. Peça uma imagem ao seu agente. É isso.

Para Claude Code:

claude mcp add pixfaro -e PIXFARO_KEY=pf_live_… -- npx -y @pixfaro/mcp

Clientes que suportam HTTP streamable também podem usar a forma remota no mesmo arquivo — sem chave, OAuth no primeiro 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

Ambiente

Variável	Significado
PIXFARO_KEY	sua chave de API (pf_live_…) — obrigatória para tudo, exceto models
PIXFARO_API_URL	substituição de endpoint (padrão https://api.pixfaro.com)

O que é este repositório

O cliente aberto e enxuto sobre a API Pixfaro: o servidor MCP (@pixfaro/mcp) e o CLI pixfaro compartilham um único cliente HTTP. A camada de saldo/provedor fica atrás de api.pixfaro.com — este código é intencionalmente pequeno o suficiente para ser lido antes de você entregar uma chave a ele.

MIT © Pixfaro