Skip to main content
Glama
CantoneseTTS.com MCP Server

CantoneseTTS.com MCP Server

Official
by cantonesetts
README.md
# <img src="./logo.png" alt="CantoneseTTS.com" width="44" align="absmiddle" /> CantoneseTTS.com MCP Server (`cantonesetts-mcp`)

Official Model Context Protocol (MCP) connector for **[CantoneseTTS.com](https://cantonesetts.com)** — the Hong Kong Cantonese AI Voiceover, Konglish & Frame-Synced `.SRT` Subtitle Studio.

Save **45 minutes per video** on written-to-spoken Hong Kong Cantonese script rewriting (`書面語轉地道口語`), 7-emotion vocal directing, and CapCut / Premiere Pro `.SRT` + `.VTT` subtitle timeline alignment.

- **Studio & Live Audition**: [https://cantonesetts.com](https://cantonesetts.com)
- **Developer Portal & API Keys**: [https://cantonesetts.com/zh-HK/developer](https://cantonesetts.com/zh-HK/developer)
- **Full REST API + MCP Specification**: [https://cantonesetts.com/api-docs.md](https://cantonesetts.com/api-docs.md)
- **Cantonese VO & Creator Case Studies**: [https://cantonesetts.com/zh-HK/blog](https://cantonesetts.com/zh-HK/blog)

---

## Available MCP Tools

1. `synthesize_cantonese_tts` — Synthesize authentic Hong Kong Cantonese & Konglish speech with 7-emotion directing (`happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `neutral`), returning a clean `.mp3` URL plus frame-aligned `.srt` and `.vtt` subtitles.
2. `list_cantonese_voices` — List all 19 curated Hong Kong Cantonese, Konglish bilingual, and Studio VIP 3-track signature voices.
3. `check_character_wallet` — Inspect real-time PostgreSQL character wallet balance and plan tier.

---

## Quick Setup

### Option A: Direct Remote Streamable HTTP (Claude Code / Cursor / Windsurf)

```json
{
  "mcpServers": {
    "cantonesetts": {
      "type": "http",
      "url": "https://cantonesetts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_YOUR_STUDIO_VIP_KEY"
      }
    }
  }
}
```

### Option B: Local Zero-Dependency STDIO Bridge (`npx`)

```json
{
  "mcpServers": {
    "cantonesetts": {
      "command": "npx",
      "args": ["-y", "cantonesetts-mcp"],
      "env": {
        "CANTONESETTS_API_KEY": "ct_live_YOUR_STUDIO_VIP_KEY"
      }
    }
  }
}
```

## License

MIT — see [LICENSE](./LICENSE).