promptpilot-mcp-server

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): ``json { "mcpServers": { "promptpilot": { "command": "npx", "args": ["-y", "promptpilot-mcp"], "env": { "POLLINATIONS_API_KEY": "sk_your_key_here" } } } } ``

Cursor

Add to ~/.cursor/mcp.json: ``json { "mcpServers": { "promptpilot": { "command": "npx", "args": ["-y", "promptpilot-mcp"] } } } ``

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json: ``json { "mcpServers": { "promptpilot": { "command": "npx", "args": ["-y", "promptpilot-mcp"] } } } ``

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace: ``json { "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