Cicadas local MCP
Experimental local bridge to the Cicadas AI video API: models, quotes and job status
- Pricing
- Freemium
- Platforms
- self-hosted, CLI, API
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 2 days ago
About Cicadas local MCP
Cicadas local MCP is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.
Cicadas.ai is an AI video studio that offers many video models under one credit balance. This repository is a small local stdio bridge to its customer API, shipped as an MCPB bundle for Node.js 22 or newer. The README says plainly that authenticated flows have not been verified against production: tests used fixtures and a handshake check, with no real key and no paid generation.
The default bundle exposes five read-oriented tools: list_video_models, get_credit_balance, quote_video, get_video_job and get_video_request. All need a Cicadas customer API key set as CICADAS_API_KEY, preferably read-only. Generation through create_video is off by default, and needs an opt-in setting, explicit spend confirmation, a request UUID and a credit cap. Downloading is also optional.
On the service side, the pricing page lists credit packs and monthly plans from about 9.90 dollars, quotes the exact credits before every run, and refunds credits when a generation fails. A new account gets one free watermarked 5-second video.
Install
Run in a terminal
claude mcp add cicadas-local-mcp --env CICADAS_API_KEY='<CICADAS_API_KEY>' -- npx -y https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"cicadas-local-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb"
],
"env": {
"CICADAS_API_KEY": "<CICADAS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cicadas-local-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb"
],
"env": {
"CICADAS_API_KEY": "<CICADAS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cicadas-local-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb"
],
"env": {
"CICADAS_API_KEY": "<CICADAS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cicadas-local-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb"
],
"env": {
"CICADAS_API_KEY": "<CICADAS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cicadas-local-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb"
],
"env": {
"CICADAS_API_KEY": "<CICADAS_API_KEY>"
}
}
}
}Configuration
CICADAS_API_KEYCustomer API key from Cicadas developer settings. Requires enabled customer API access.Required
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- list_video_models
- Reads the text-to-video model catalogue.
- get_credit_balance
- Reads account balance and key budget.
- quote_video
- Validates a request and estimates its credit cost.
- get_video_job
- Retrieves the status of an owned job.
- get_video_request
- Recovers an owned request by its original UUID.
- create_video
- Creates a video job (optional, off by default).
- download_video
- Downloads a finished video (optional).
What it does
- Model catalogue
- Lists the available text-to-video models.
- Credit balance
- Reads account balance and key budget.
- Cost quotes
- Estimates credits for a request without creating a job.
- Job recovery
- Looks up a job or recovers a request by its original UUID.
- Spend guards
- Generation is off by default and needs explicit confirmation and a cap.
- Local stdio
- Runs on your machine from an MCPB bundle or from source.
Good for
- Check what a video would cost before generating
- Read your credit balance from an assistant
- Check the status of a submitted video job
- Recover a request after an uncertain network failure
Pricing
Freemium, from $9.9 a month
One free watermarked video; Starter plan $9.90/mo; credit packs from $9.90
Prices change. Check cicadas.ai before you buy.
Cicadas local MCP FAQ
Is it verified against production?
No. The README says authenticated functionality has not yet been verified against a real customer key.
What do I need?
A Cicadas customer API key and Node.js 22 or newer.
Can it spend credits?
Only if generation is enabled by the operator and each call includes confirmSpend and a credit cap.
What does Cicadas cost?
Credit packs and plans start at 9.90 dollars, and a new account gets one free watermarked clip.
Is Cicadas local MCP free?
Cicadas local MCP has a free plan, with paid plans for more usage or features. Paid plans start at $9.9 a month.
How do I add Cicadas local MCP to Claude Code?
Run this command in your terminal: claude mcp add cicadas-local-mcp --env CICADAS_API_KEY='<CICADAS_API_KEY>' -- npx -y https://github.com/kevinwowo/cicadas-local-mcp/releases/download/v0.1.0/cicadas-local-mcp-0.1.0.mcpb
What are the best alternatives to Cicadas local MCP?
The closest alternatives to Cicadas local MCP are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.
Alternatives to Cicadas local MCP

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media