doctorm333/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