PromptPilot MCP Server

Generate images, video, and audio directly in Claude Code, Cursor, Windsurf, or any MCP-compatible AI agent.

20+ models — Flux, GPT-Image-1, Imagen 4, Grok Imagine, Seedance, ElevenLabs TTS, and more. Free models work without an API key. Paid models require a Pollinations key.

Installation

Claude Code / Claude Desktop

{
  "mcpServers": {
    "promptpilot": {
      "command": "npx",
      "args": ["-y", "promptpilot-mcp"]
    }
  }
}

With Pollinations API key (for paid models):

{
  "mcpServers": {
    "promptpilot": {
      "command": "npx",
      "args": ["-y", "promptpilot-mcp"],
      "env": {
        "POLLINATIONS_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "promptpilot": {
      "command": "npx",
      "args": ["-y", "promptpilot-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "promptpilot": {
      "command": "npx",
      "args": ["-y", "promptpilot-mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "promptpilot": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "promptpilot-mcp"]
    }
  }
}

Docker

docker run -i --rm \
  -e POLLINATIONS_API_KEY=sk_your_key_here \
  mcp/promptpilot-mcp

Tools (8 total)

| Tool | Description | |------|-------------| | list_models | List all image/video/audio models with pricing | | list_styles | List styles, lighting, camera, mood, color presets | | build_prompt | Build optimized prompt from structured inputs | | generate_image | Generate image (returns URL) | | generate_video | Generate video (returns URL) | | generate_audio | Generate speech or music (returns URL) | | check_balance | Check Pollinations API balance | | generate_batch | Generate up to 10 images in one call |

Examples

Generate an image:

"Generate a cyberpunk cityscape at night using the flux model"

Batch generation:

"Generate 5 product photos with different backgrounds"

Build + generate:

"Build me a portrait prompt with dramatic lighting and golden hour mood, then generate it"

Check what's available:

"What video models do you have and what are their prices?"

REST API

PromptPilot also offers a REST API for programmatic access from any language:

# Get your token at https://promptpilot.club/profile (REST API tab)

curl https://promptpilot.club/api/v1/generate \
  -H "Authorization: Bearer pp_your_token" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "red panda in bamboo forest", "model": "flux", "fields": "url,model"}'

Endpoints:

• POST /api/v1/generate — generate image/video/audio
• GET /api/v1/models — list models with prices
• GET /api/v1/balance — check balance
• GET /api/v1/schema — OpenAPI schema
• GET /api/v1/AGENT_CONTEXT.md — quick reference for agents

Links

• promptpilot.club — Web UI
• Pollinations AI — Underlying model provider
• npm package
• GitHub

License

MIT