{
  "markdown": "# Pixfaro MCP — image generation MCP server for every image model\n\nOne MCP connection, one prepaid balance, every major image model — Nano Banana,\nGemini today, GPT Image next (visible as \"coming soon\" in `list_models`).\nPixfaro holds the provider accounts, keys, retries and format differences;\nyour agent just asks for an image.\n\nWorks with **Claude Desktop, Claude Code, Cursor, Windsurf**, and any MCP client.\n\n## Quickstart — no terminal needed (≈1 minute)\n\nThe remote server is the easiest path: paste one URL, sign in with your\nPixfaro account in the browser window that opens. No API key in any file.\n\n**Claude** (claude.ai / Claude Desktop, any plan): **Settings → Connectors →\nAdd custom connector** → URL `https://mcp.pixfaro.com/mcp` → sign in.\n(Team/Enterprise: an org Owner adds it once under **Organization settings →\nConnectors → Custom → Web**.)\n\n**Cursor**: [**Add to Cursor →**](https://cursor.com/install-mcp?name=pixfaro&config=eyJ1cmwiOiJodHRwczovL21jcC5waXhmYXJvLmNvbS9tY3AifQ%3D%3D)\n— or **Cursor Settings → MCP → Add new MCP server** (type **URL**, address\n`https://mcp.pixfaro.com/mcp`); Cursor runs the OAuth flow itself.\n\n**ChatGPT** (Pro/Plus/Business/Edu): **Settings → enable Developer mode**\n(connectors live under **Plugins** since the July 2026 rename, formerly\n**Connectors → Advanced**) → add a custom connector with URL\n`https://mcp.pixfaro.com/mcp`, OAuth.\n\n## Quickstart — command line / config file\n\n1. Get an API key at [pixfaro.com](https://pixfaro.com) and top up (no subscription).\n2. Add the server to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"pixfaro\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@pixfaro/mcp\"],\n      \"env\": { \"PIXFARO_KEY\": \"pf_live_…\" }\n    }\n  }\n}\n```\n\n3. Ask your agent for an image. That's it.\n\nFor Claude Code:\n\n```bash\nclaude mcp add pixfaro -e PIXFARO_KEY=pf_live_… -- npx -y @pixfaro/mcp\n```\n\nClients that speak streamable HTTP can also take the remote form in the same\nfile — no key, OAuth on first use:\n\n```json\n{ \"mcpServers\": { \"pixfaro\": { \"url\": \"https://mcp.pixfaro.com/mcp\" } } }\n``` Clients\nwithout OAuth can pass an API key instead: `Authorization: Bearer pf_live_…`.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `generate_image` | prompt → hosted image URL (+cost and balance in the reply) |\n| `edit_image` | natural-language edit of a previous generation by its `img_…` id |\n| `list_models` | models with price, latency, and what each is best for |\n| `render_template` | typeset card (quote/post) from a template — $0.02, ~2 s, sharp type · *remote server; npx parity coming in 0.2* |\n| `list_templates` | card templates with slots, style axes and exact prices · *remote server* |\n| `upload_asset` | upload a PNG/JPEG (≤5 MB) as a reusable asset (e.g. a card avatar) · *remote server* |\n| `get_balance` | current prepaid balance |\n\nReplies carry a hosted URL, never base64 — your agent's context stays small.\n\nBoth generation tools accept `aspect_ratio` (e.g. `\"16:9\"`, `\"9:16\"`). Edits\nkeep the source image's shape when you omit it — pass one only to reshape.\n\n## CLI\n\nThe same package family ships an unscoped CLI for scripts, CI, and pipelines:\n\n```bash\nexport PIXFARO_KEY=pf_live_…\nnpx pixfaro gen \"a lighthouse at night, minimal flat style\" -a 16:9 -o cover.png\nnpx pixfaro models\nnpx pixfaro balance\nnpx pixfaro edit img_8f2a… \"make the sky darker\" -o v2.png\n```\n\n## Environment\n\n| Variable | Meaning |\n|---|---|\n| `PIXFARO_KEY` | your API key (`pf_live_…`) — required for everything except `models` |\n| `PIXFARO_API_URL` | endpoint override (default `https://api.pixfaro.com`) |\n\n## What this repo is\n\nThe thin open client over the Pixfaro API: the MCP server (`@pixfaro/mcp`) and\nthe `pixfaro` CLI share one HTTP client. The balance/provider layer lives\nbehind [api.pixfaro.com](https://pixfaro.com) — this code is intentionally\nsmall enough to read before you hand it a key.\n\nMIT © Pixfaro\n",
  "bytes": 3907,
  "sha": "88979a76c3f60a626c44f78fec1d58942699805f38079da62dead99c34f78f1b",
  "repo_slug": "pixfaro/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_pixfaro_mcp_4784c7d6/readme"
}