MCP server overview
what is Model Context Protocol?
Model Context Protocol (MCP) server from Pollinations — an open-source, lightweight “thin proxy” that enables AI assistants (e.g., Claude) and MCP clients to generate images, text, and audio via STDIO. It exposes multimodal generation capabilities (image URL/base64, text, TTS) and model listing through a simple Node.js service.
how to use the project?
- Quick start (no install):
npx @pollinations/model-context-protocol - Global install:
npm install -g @pollinations/model-context-protocolthen runpollinations-mcp - Use STDIO transport for integration: e.g.
npx supergateway --stdio -- pollinations-mcp - Install into Claude Desktop:
npx @pollinations/model-context-protocol install-claude-mcpthen restart Claude Desktop - System requirements: Node.js >=14 supported (Node.js >=16 recommended). Check with
node --version.
key features of the project
- Generate image URLs and full images returned as base64 from text prompts
- Generate text responses and text-to-speech audio
- List available image and text models
- STDIO-only transport for simple local/CLI integration (no HTTP server)
- Thin-proxy design with minimal data transformation and reduced dependencies
- Tools provided: generateImageUrl, generateImage, respondAudio, sayText, generateText, listModels
use cases of the project
- Adding multimodal generation to AI assistants (Claude, other MCP clients)
- Local command-line prompt-driven image/audio/text generation workflows
- Lightweight bridge for embedding Pollinations generation into apps without running an HTTP server
- Developer testing and CI workflows that use STDIO-based model integrations
FAQ from the project
- What Node version do I need?
Node 14+ is supported; Node 16+ is recommended for best compatibility.
- I see “ReferenceError: AbortController is not defined” — how to fix?
Update Node to >=16 (recommended), use package v1.0.6+ (includes a polyfill), or install a polyfill like
node-abort-controller.
- Does the server use HTTP or sockets?
No — v1.0.7 removed HTTP components; it uses stdio-only transport following MCP best practices.
- How do I integrate with Claude Desktop?
Run
npx @pollinations/model-context-protocol install-claude-mcpto update Claude Desktop config automatically, then restart Claude Desktop.
- Is this open source and production-ready?
Yes, it’s MIT-licensed and designed to be simple and lightweight for local and integration use; review changelog and requirements for compatibility notes.