# Cicadas local MCP

> Cicadas local MCP is a freemium MCP server for design and media. Experimental local bridge to the Cicadas AI video API: models, quotes and job status. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.9 a month
- **Platforms:** self-hosted, CLI, API
- **Website:** https://cicadas.ai
- **Repository:** https://github.com/kevinwowo/cicadas-local-mcp
- **MCP Registry name:** io.github.kevinwowo/cicadas-local-mcp
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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).

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/cicadas-local-mcp
