PromptPilot MCP Server

Generate images, video, and audio directly in AI agents.

README.md

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

License

MIT

Tools 8

list_modelsList all image/video/audio models with pricing
list_stylesList styles, lighting, camera, mood, color presets
build_promptBuild optimized prompt from structured inputs
generate_imageGenerate image (returns URL)
generate_videoGenerate video (returns URL)
generate_audioGenerate speech or music (returns URL)
check_balanceCheck Pollinations API balance
generate_batchGenerate up to 10 images in one call

Environment Variables

POLLINATIONS_API_KEYAPI key required for paid models

Try it

Generate a cyberpunk cityscape at night using the flux model
Generate 5 product photos with different backgrounds
Build me a portrait prompt with dramatic lighting and golden hour mood, then generate it
What video models do you have and what are their prices?

Frequently Asked Questions

What are the key features of PromptPilot?

Supports 20+ models including Flux, GPT-Image-1, Imagen 4, and ElevenLabs TTS. Provides tools for image, video, and audio generation. Includes prompt optimization and style preset management. Supports batch image generation for efficiency. Offers both free and paid model access via Pollinations API.

What can I use PromptPilot for?

Rapidly prototyping visual assets for UI/UX design directly within an IDE. Generating consistent media assets for content creation workflows. Automating the creation of multiple image variations for marketing materials. Integrating text-to-speech or music generation into AI-assisted development tasks.

How do I install PromptPilot?

Install PromptPilot by running: npx -y promptpilot-mcp

What MCP clients work with PromptPilot?

PromptPilot works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep PromptPilot docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare