article

README

Pollinations Multimodal MCP Server

A Model Context Protocol (MCP) server for the Pollinations APIs that enables AI assistants like Claude to generate images, text, and audio directly. This server follows the "thin proxy" design principle, focusing on minimal data transformation and direct communication through stdio.

Features

Generate image URLs from text prompts
Generate actual images and return them as base64-encoded data
Generate text responses from text prompts
Generate audio (text-to-speech) from text prompts
List available image and text generation models
STDIO transport for easy integration with MCP clients
Simple and lightweight
Compatible with the Model Context Protocol (MCP)

System Requirements

Node.js: Version 14.0.0 or higher
- For best performance, we recommend Node.js 16.0.0 or higher
- Node.js versions below 16 use an AbortController polyfill

Quick Start

The easiest way to use the MCP server:

# Run directly with npx (no installation required)
npx @pollinations/model-context-protocol

If you prefer to install it globally:

# Install globally
npm install -g @pollinations/model-context-protocol

# Run the server
pollinations-mcp

Transport

The MCP server exclusively uses STDIO transport, which is ideal for local integrations and command-line tools:

# Run with STDIO transport
npx @pollinations/model-context-protocol

For MCP clients, connect using:

npx supergateway --stdio -- pollinations-mcp

Claude Desktop Integration

To install the MCP server in Claude Desktop:

# Run the installation script
npx @pollinations/model-context-protocol install-claude-mcp

This script will automatically:

Find the Claude Desktop configuration file for your OS
Add the Pollinations MCP server to the configuration
Configure it to use npx for easy updates

After installation, restart Claude Desktop and you can use commands like:

Generate an image of a sunset over the ocean using the Pollinations API.

Alternative MCP Implementations

MCPollinations: A community-maintained alternative MCP server supporting similar capabilities. Available at GitHub and NPM.

Troubleshooting

"AbortController is not defined" Error

If you encounter this error when running the MCP server:

ReferenceError: AbortController is not defined

This is usually caused by running on an older version of Node.js (below version 16.0.0). Try one of these solutions:

Update Node.js (recommended):
- Update to Node.js 16.0.0 or newer

Use our polyfill (automatic in version 1.0.6+):

Update to the latest version of the package:

npm install -g @pollinations/model-context-protocol@latest
# or run with npx
npx @pollinations/model-context-protocol@latest

Install AbortController manually:
- If for some reason the polyfill doesn't work:
```
npm install node-abort-controller
```

Check Your Node.js Version

To check your current Node.js version:

node --version

If it shows a version lower than 16.0.0, consider upgrading for best compatibility.

Available Tools

The MCP server provides the following tools:

Content Generation

generateImageUrl - Generates an image URL from a text prompt
generateImage - Generates an image and returns it as base64-encoded data
respondAudio - Generates an audio response to a text prompt
sayText - Generates speech that says the provided text verbatim
generateText - Generates text from a prompt using text models
listModels - Lists available models for image or text generation

Changelog

Version 1.0.7

Simplified architecture by removing HTTP server components
Transitioned to stdio-only transport following MCP best practices
Removed authentication server (moved to separate github-app-auth service)
Reduced dependencies for a smaller, more focused package
Updated documentation to reflect the new architecture

Version 1.0.6

Added compatibility with Node.js versions 14.0.0 and later
Added AbortController polyfill for Node.js versions below 16.0.0
Fixed "AbortController is not defined" error
Improved error handling and reporting
Added troubleshooting guide in README
Enhanced documentation with system requirements and installation options

Version 1.0.5

Initial public release

License

MIT

pollinations