nectar-mcp
A stdio MCP server for Pollinations image generation, image editing, video generation, audio generation, model discovery, and pollen balance checks.
Install / Use
claude mcp add pinkpixel-dev -- npx -y github:pinkpixel-dev/nectar-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OtherSupported Platforms
Our assessment of nectar-mcp
nectar-mcp scores 81/100 on our quality scale, 285th of 329 Other skills we index.
Its MCP Server is 5.9 KB long, well organised into 9 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 29 days ago, so nectar-mcp is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
nectar-mcp compared with similar skills
All 4 of these similar skills score higher than nectar-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nectar-mcp (this skill)by pinkpixel-dev | 81 | 3 | 29d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 118.9k | 11d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install nectar-mcp?
- Run
claude mcp add pinkpixel-dev -- npx -y github:pinkpixel-dev/nectar-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does nectar-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is nectar-mcp safe to use?
- It is Apache-2.0-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is nectar-mcp still maintained?
- The repository was last updated 29 days ago, so nectar-mcp is actively maintained.
Skill content
View source on GitHubNectar MCP
Nectar is a stdio MCP server for Pollinations image, video, and audio generation. It gives MCP clients a focused set of creative media tools.
You can generate and edit images, create videos, and generate speech, music, or sound effects. Nectar also lists live models and checks pollen balance. It is intentionally not a full Pollinations wrapper. Text generation, transcription, embeddings, and unrelated account tools remain out of scope.
Tools
| Tool | Purpose |
| --- | --- |
| pollinations_list_models | Lists current image, video, and audio models from Pollinations using separate 15-minute catalog caches, compact summaries, sorting, and capability filters. |
| pollinations_get_model_details | Returns full metadata for one image, video, or audio model by name or alias. |
| pollinations_generate_image | Generates an image from a text prompt with model, size/dimensions, quality, seed, safety, transparency, prompt enhancement, negative prompt, reference image, and response format options. |
| pollinations_edit_image | Edits one or more image URLs using a text prompt, with model, size/dimensions, quality, seed, safety, transparency, prompt enhancement, negative prompt, and response format options. |
| pollinations_generate_video | Generates a video from a text prompt, with model, duration, aspect ratio, resolution, seed, audio, safety, quality, and reference-frame controls. |
| pollinations_generate_audio | Generates speech, music, or sound effects with a selected audio model and optional voice, then saves the returned audio locally by default. |
| pollinations_check_balance | Checks the authenticated pollen balance or API key budget. |
Requirements
- Node.js 20 or newer
- A Pollinations API key from enter.pollinations.ai
Model listing does not require authentication. Generation and balance tools require POLLINATIONS_API_KEY.
Generated images, edited images, videos, and audio are saved locally by default. Set NECTAR_OUTPUT_DIR in your MCP client environment block to choose the default output folder. You can also pass output_dir per tool call.
Install
MCP Client Config
Most MCP clients should pass the API key through the server env block:
{
"mcpServers": {
"pixara": {
"command": "npx",
"args": ["-y", "@pinkpixel/nectar-mcp"],
"env": {
"POLLINATIONS_API_KEY": "sk_y…[redacted]",
"NECTAR_OUTPUT_DIR": "/absolute/path/to/nectar-output"
}
}
}
}
For local development:
git clone https://github.com/pinkpixel-dev/nectar-mcp.git
cd nectar-mcp
npm install
npm run build
{
"mcpServers": {
"nectar": {
"command": "node",
"args": ["/absolute/path/to/nectar-mcp/dist/index.js"],
"env": {
"POLLINATIONS_API_KEY": "sk_y…[redacted]",
"NECTAR_OUTPUT_DIR": "/absolute/path/to/nectar-output"
}
}
}
}
Example Requests
Ask your MCP client:
List Pollinations video models and help me choose one for a 9:16 product teaser.
Generate a 1024x1024 image of a tiny yellow robot painter in a polished dark UI style.
Edit this image URL so the background is transparent and the subject looks more premium.
Generate a 6 second 16:9 video of a glowing pollen trail drifting across a dark studio surface.
Generate a warm spoken welcome with the nova voice using a current Pollinations speech model.
Generate a short lo-fi instrumental with soft piano, brushed drums, and a quiet vinyl texture.
Generate the sound of a heavy wooden door closing in a large stone hall.
Notes
- Image generation uses Pollinations' OpenAI-compatible image generation endpoint.
- Image editing currently supports image URLs. Local multipart file upload is intentionally left out of v1.
- Image, video, and audio tools default to
save_output: true, converting base64 responses and downloaded URLs into local files. - Image generation and image editing default to Pollinations
response_format: "b64_json"because local decoding is the most reliable save path. - Saved files go to
output_dir,NECTAR_OUTPUT_DIR, or./nectar-output, in that order. - Saved Pollinations media URLs are downloaded with the configured
POLLINATIONS_API_KEY. Nectar does not send that key to non-Pollinations URLs. - Tool descriptions intentionally include model examples, parameter guidance, return shape notes, and error-handling hints so MCP clients have enough context to call the tools correctly.
- Model listing is compact by default. Audio discovery reads
/audio/models, including live voice metadata when Pollinations supplies it. - Use
pollinations_get_model_detailswhen an agent needs full raw metadata for one model. - Video generation returns the final media URL and response metadata.
- Audio generation uses
GET /audio/{text}. The selected model determines whether the prompt produces speech, music, or a sound effect. - Audio saving detects common MP3, WAV, FLAC, Ogg/Opus, AAC, MP4 audio, WebM audio, and PCM media types.
- Model support varies by capability, so call
pollinations_list_modelsbefore using model-specific options. - The server never stores your API key. Your MCP client passes it through the process environment.
Development
npm run typecheck
npm run build
The server communicates over stdio and will stay running when started directly. Use an MCP client or inspector to interact with it.
License
Apache-2.0
Made by Pink Pixel.
Related Skills
taste-skill
118.9kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.