CantoneseTTS.com MCP Server
Officialby 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).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues