mcp.film

mcp.film / Avatars & Performance / Hedra MCP Server

Hedra MCP Server

Communityby Community (pasie15)creditsverified Oct 22, 2026

Character-3 talking-avatar video, TTS, and image generation through Hedra's API.

What it does

Node MCP server for Hedra's generation API: lip-synced character video from an image plus audio (Character-3), text-to-speech, image generation, and asset/credit management. Its README also advertises third-party models reachable through Hedra Studio, though that list dates from the server's only release and has since drifted from Hedra's own roster.

Connect

Claude Code
claude mcp add hedra -e HEDRA_API_KEY=YOUR_KEY -- npx -y mcp-server-hedra
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "hedra": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-hedra"
      ],
      "env": {
        "HEDRA_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "hedra": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-hedra"
      ],
      "env": {
        "HEDRA_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Auth: api_key · env HEDRA_API_KEY — https://www.hedra.com/develop/api-keys (legacy API used by this server bills Studio credits and needs a paid subscription)

Sample tools

generate_videogenerate_video_with_ttsgenerate_text_to_speechgenerate_imageupload_assetlist_modelsget_generation_statusget_credits

Field notes

Use `hedra-official` (mcp.hedra.com, shipped 2026-08-31) by default — OAuth instead of a pasted key, the current model roster instead of a frozen one, and Hedra's own quickstart now points MCP clients there. This server has fallen a full API generation behind: Hedra has since launched a v3 API (api.hedra.com/v3, `Authorization: Key <key_id>:<secret>`, billed from a separate prepaid USD wallet), while this server's source still calls the legacy api.hedra.com/web-app/public endpoints with an X-API-Key header. Hedra's v2-to-v3 migration guide says the legacy API remains available for existing integrations with no announced shutdown date, but recommends v3 for anything new — so this works today on borrowed time, and a v3 key will not authenticate it. Billing trap: the legacy API draws on Studio credits plus a paid subscription, and Hedra warns that Studio credits do not fund v3, so do not mix the two up when topping up. Re-checked 2026-10-22: npm mcp-server-hedra is still the only release, 1.0.0 from 2026-02-08; the repo has had no push since that day, MIT, Node 18+, 2 stars — treat it as unmaintained. Its README's /api-profile key link is stale (the page is hedra.com/develop/api-keys) and its third-party model list dates from February. Character-3 itself is alive — it is a v3 model now (`hedra-character-3`), described as Hedra's longform avatar model.

Also in Avatars & Performance

Used in

Character-Consistent Series · Build a character-consistent series · Create avatar, talking-head, or UGC-style video

Pairs well with