Skip to content
MCP server

Cicadas local MCP

Experimental local bridge to the Cicadas AI video API: models, quotes and job status

Runs locallyStatus and history
Install
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.mcpb

Add 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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP 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
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media