# doctorm333/promptpilot-mcp-server [Health: Active]

**Category:** 🎨 Art & Culture  
**Repository:** https://github.com/doctorm333/promptpilot-mcp-server  
**GitHub Stars:** 2  
**npm Downloads (last month):** 66  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/doctorm333-promptpilot-mcp-server

## Description
Generate images, video, and audio via 20+ AI models (Flux, GPT-Image-1, Imagen 4, Grok, Seedance, ElevenLabs). Prompt builder with styles, lighting, camera, mood presets. Batch generation support.

## Tools
Capabilities this server exposes over MCP:

- **list_models** — List all available models for image, video, and audio generation with their type and pricing
- **list_styles** — List all available styles, lighting, camera angles, moods, colors, and quality tags for prompt building
- **build_prompt** — Build an optimized prompt from subject + style/lighting/camera/mood/color/quality options
- **generate_image** — Generate an image using Pollinations API. Returns a URL to the generated image.
- **generate_video** — Generate a video using Pollinations API. Returns a URL to the generated video.
- **generate_audio** — Generate audio (speech or music) using Pollinations API. Returns a URL to the generated audio.
- **check_balance** — Check your Pollinations API balance (pollen). Shows remaining credits for paid models.
- **generate_batch** — Generate multiple images in one call (up to 10). More efficient than calling generate_image repeatedly.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `POLLINATIONS_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# 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](https://pollinations.ai) key.

---

## Installation

### Claude Code / Claude Desktop

```json
{
  "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

```bash
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:

```bash
# 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](https://promptpilot.club) — Web UI
- [Pollinations AI](https://pollinations.ai) — Underlying model provider
- [npm package](https://www.npmjs.com/package/promptpilot-mcp)
- [GitHub](https://github.com/doctorm333/promptpilot-mcp-server)

## License

MIT