# mcp

One MCP connection gives your coding agent image generation and editing, billed from a single prepaid balance. Provider keys stay on Pixfaro's side.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: pixfaro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pixfaro/mcp
- Updated: 2026-08-24
- HTML: https://affpapa.org/en/nevibecode/mcp/pixfaro-mcp

## What it does

The server exposes `generate_image`, `edit_image`, `list_models`, `get_balance` and a few more tools. A prompt comes back as a hosted URL instead of base64, so your agent's context stays small. Edits reference an earlier generation by its `img_…` id — ask for a darker sky without describing the picture again.

Two ways in. Remote: paste `https://mcp.pixfaro.com/mcp` and sign in through the browser, no key stored anywhere. Local: run `npx -y @pixfaro/mcp` with `PIXFARO_KEY` set. Pick the second when your client has no OAuth. The endpoint can be pointed elsewhere with `PIXFARO_API_URL`; it defaults to `https://api.pixfaro.com`.

Nothing works without a `pf_live_…` key except `list_models`. There is no subscription — you top up the balance at pixfaro.com first. Some tools (`render_template`, `list_templates`, `upload_asset`) exist only on the remote server and are not in the `npx` build yet.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.pixfaro.com/mcp`
- Environment variables: `PIXFARO_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.pixfaro.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env PIXFARO_KEY=<PIXFARO_KEY> --transport stdio pixfaro-mcp -- npx -y @pixfaro/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add pixfaro-mcp --url https://mcp.pixfaro.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add pixfaro-mcp --env PIXFARO_KEY=<PIXFARO_KEY> -- npx -y @pixfaro/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pixfaro-mcp": {
            "url": "https://mcp.pixfaro.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pixfaro-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pixfaro/mcp"
            ],
            "env": {
                "PIXFARO_KEY": "<PIXFARO_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pixfaro-mcp": {
            "type": "http",
            "url": "https://mcp.pixfaro.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pixfaro-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pixfaro/mcp"
            ],
            "env": {
                "PIXFARO_KEY": "<PIXFARO_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http pixfaro-mcp https://mcp.pixfaro.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e PIXFARO_KEY=<PIXFARO_KEY> pixfaro-mcp npx -y @pixfaro/mcp
```
Replace <…> with your own values

## When to use it
- generate an image from a text prompt without leaving the agent
- edit an existing picture by describing the change
- compare model prices and latency before spending
- check the remaining balance
- typeset a quote or post card from a template

## Example prompts
- Generate a 16:9 cover image for a post about a lighthouse
- Make the sky darker on `img_8f2a…`
- List the models with prices and tell me which suits flat minimal illustrations

## Similar
- [nano-banana-2](https://affpapa.org/en/nevibecode/skills/nano-banana-2.md) — skill · 437700 installs
- [runcomfy-cli](https://affpapa.org/en/nevibecode/skills/runcomfy-cli.md) — skill · 380100 installs
- [mmx-cli](https://affpapa.org/en/nevibecode/skills/mmx-cli.md) — skill · 32000 installs
- [gpt-image-2](https://affpapa.org/en/nevibecode/skills/pilioai-gpt-image-2.md) — skill · 20300 installs
- [p-image](https://affpapa.org/en/nevibecode/skills/p-image.md) — skill · 12400 installs
- [gpt-image](https://affpapa.org/en/nevibecode/skills/gpt-image.md) — skill · 12300 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md