Log inSubmit server
Promptpilot MCP Server logo

Promptpilot MCP Server

by doctorm333

Generate images, video, and audio through Pollinations with prompt-building tools and batch image generation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Promptpilot MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "doctorm333-promptpilot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "promptpilot-mcp"
      ],
      "env": {
        "POLLINATIONS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

doctorm333/promptpilot-mcp-server MCP server connects MCP-compatible agents to Pollinations for generating images, video, and audio. It provides tools for discovering models and prompt presets, constructing prompts, checking balance, and generating media URLs. Free models can run without an API key, while paid models require POLLINATIONS_API_KEY. Use it when an agent needs structured creative-media generation from Claude Code, Claude Desktop, Cursor, Windsurf, or VS Code.

Use cases

  • Generate images from structured style and lighting choices
  • Create short videos through an MCP-compatible agent
  • Produce speech or music with Pollinations audio models
  • Build prompts before sending them to a media model
  • Generate up to 10 image variations in one request

Key features

  • Image, video, and audio generation
  • Model and pricing discovery
  • Structured prompt builder with creative presets
  • Pollinations balance checks
  • Batch image generation for up to 10 images
  • MCP stdio and Docker setup options

Tools8

What Promptpilot MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

12/12 checks healthy over the last 59d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · promptpilot-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads107Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed8Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Promptpilot MCP Server works

What doctorm333/promptpilot-mcp-server does

doctorm333/promptpilot-mcp-server exposes Pollinations media-generation features through MCP. An agent can request images, video, speech, or music and receive a URL for the generated result. The server also provides discovery and prompt-composition tools, so an agent can inspect available models and build prompts from structured creative options.

The available model catalog covers image, video, and audio generation. The README identifies examples including Flux, GPT-Image-1, Imagen 4, Grok Imagine, Seedance, and ElevenLabs text-to-speech. Availability and pricing are exposed through the model-listing tool rather than hardcoded assumptions in the agent workflow.

How it works

The server runs as an MCP process and communicates with an MCP client over standard input and output. Requests are forwarded to the Pollinations API for generation. Image, video, and audio tools return URLs instead of embedding the generated media in the tool response.

Prompt construction is separate from generation. An agent can first inspect style, lighting, camera, mood, color, and quality presets, then pass selected values to the prompt builder. It can use the resulting prompt with a generation tool. Batch generation supports up to 10 images in one call, which is useful for producing multiple image results without issuing separate image requests.

The check-balance tool reports remaining Pollinations credits, called pollen, for paid models. Free models do not require a Pollinations key; paid models do.

Setup and configuration

To install doctorm333/promptpilot-mcp-server, configure the package as an MCP stdio server with npx -y promptpilot-mcp. The README provides configurations for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code. It also documents a Docker invocation using the mcp/promptpilot-mcp image.

Set POLLINATIONS_API_KEY in the MCP server environment when the agent needs paid models. The key is not required for free models. The same environment variable can be passed to the Docker container with -e.

Tools and capabilities

The eight documented tools are:

  • list_models: shows image, video, and audio models with type and pricing information.
  • list_styles: returns style, lighting, camera, mood, color, and quality options.
  • build_prompt: creates a prompt from a subject and selected preset values.
  • generate_image: requests an image and returns its URL.
  • generate_video: requests a video and returns its URL.
  • generate_audio: requests speech or music and returns its URL.
  • check_balance: reports the Pollinations balance.
  • generate_batch: creates up to 10 images in one request.

The repository also documents a separate REST API for programmatic access. Its endpoints cover generation, model listing, balance checks, and an OpenAPI schema, but that API is distinct from the MCP tool interface.

Limitations and notes

doctor m333/promptpilot-mcp-server depends on Pollinations for the underlying media generation. Paid-model access depends on a valid Pollinations API key and available credits. Generated results are exposed as URLs, so clients or downstream workflows must handle retrieving or presenting those URLs. Batch generation is limited to 10 images per call.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Promptpilot MCP Server

doctorm333/promptpilot-mcp-server is an MCP server that connects AI agents to Pollinations API for image, video, and audio generation. Its tools list models and prompt presets, build prompts, generate media, check account balance, and create up to 10 images in one batch. Free models do not require an API key.

Install it by configuring an MCP client to run `npx -y promptpilot-mcp`. The documented setup supports Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code, and a Docker image is also provided.

Yes, doctorm333/promptpilot-mcp-server works with Cursor through its MCP configuration file. Add a `promptpilot` server entry to `~/.cursor/mcp.json` with `npx` and the `-y promptpilot-mcp` arguments.

No, a key is not needed for free models. Set `POLLINATIONS_API_KEY` when using paid Pollinations models, which consume available pollen credits.

Yes, its `generate_batch` tool generates up to 10 images in one call. Each result is returned as a URL, making the tool suitable for producing several image variations without repeated `generate_image` calls.

Related MCP servers

All in Art & Culture All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPromptpilot MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/doctorm333-promptpilot-mcp-server?style=directory)](https://allmcps.com/mcp/doctorm333-promptpilot-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/doctorm333-promptpilot-mcp-server"><img src="https://allmcps.com/api/badge/doctorm333-promptpilot-mcp-server?style=directory" alt="Promptpilot MCP Server on AllMCPs" /></a>