
cantonesetts-mcp
com.cantonesetts/cantonesetts-mcp
Hong Kong Cantonese & Konglish AI voiceover + frame-synced SRT/VTT subtitle MCP server.
Documentation
CantoneseTTS.com MCP Server (cantonesetts-mcp)
Turn written Chinese or spoken Hong Kong Cantonese scripts into broadcast-ready .MP3 voiceovers + frame-synced CapCut / Premiere Pro .SRT & .VTT subtitles in a single AI agent tool call.
What Is CantoneseTTS.com MCP?
CantoneseTTS.com MCP (cantonesetts-mcp) is the official Model Context Protocol (MCP) server for CantoneseTTS.com, a dedicated Hong Kong Cantonese AI voiceover, bilingual Konglish, and frame-aligned .SRT subtitle production engine.
When connected to Claude Desktop, Claude Code, Cursor, Windsurf, Cline, or custom AI agents, your assistant can directly audition 30+ Hong Kong Cantonese voices, direct 7 vocal emotions, normalize Hong Kong written copy into natural spoken Cantonese (書面語轉地道香港口語), and return both a clean .mp3 audio URL and ready-to-import .srt + .vtt subtitle timelines in one step.
Why teams use this instead of raw TTS APIs: Standard global TTS engines read written Chinese word-for-word with robotic mainland/Mandarin cadence, mispronounce Hong Kong English code-switching (
OT,Briefing,Pitch Deck,HK$388), and only output raw audio bytes without subtitle timing. CantoneseTTS.com automates script localization, authentic HK cadence, and.SRTsubtitle synchronization together, saving Hong Kong founders, marketers, and video editors 45 minutes per short video.
What Does This Tool Actually Do? (End-to-End Workflow)
When you ask your AI agent "Generate an upbeat Hong Kong Cantonese Reels voiceover and SRT subtitles for our HK$388 flash sale", this MCP server executes four production steps behind one tool call:
- Spoken Hong Kong Cantonese & Konglish Prosody: Handles authentic Hong Kong colloquial particles (
啦,喎,㗎,嘅), natural Cantonese-English code-switching (Konglish), and spoken HKD currency/date phrasing. - 30 Curated Hong Kong Voices + 7-Emotion Vocal Directing: Selects from 30 Hong Kong studio voices (commercial hosts, e-commerce flash-sale anchors, late-night storytellers, corporate narrators, animated characters) with explicit emotion control (
neutral,happy,sad,angry,fearful,disgusted,surprised) plus speed, pitch, and volume tuning. - Instant
.MP3+ Frame-Synced.SRT&.VTTOutput: Generates high-clarity.mp3audio AND frame-accurate.srt/.vttTraditional Chinese subtitle files in the same response, ready to drag straight into CapCut (剪映專業版), Adobe Premiere Pro, Final Cut Pro, or DaVinci Resolve without running a separate Whisper transcription pass. - Transparent Character Wallet Accounting: Checks and deducts exact character usage against your CantoneseTTS.com Studio Wallet with real-time balance reporting.
Comparison: CantoneseTTS.com MCP vs. Generic Speech Tools
| Capability | CantoneseTTS.com MCP | Generic Global TTS Platforms | Raw Cloud Speech APIs |
|---|---|---|---|
Native Hong Kong Spoken Cadence (地道香港粵語口語) | Built specifically for HK Cantonese & particles | Often drifts into accented or stiff phrasing | Requires custom phoneme tuning |
Bilingual Konglish Code-Switching (中英夾雜) | Seamless HK workplace & retail English mixing | Misreads English terms mid-sentence | Breaks rhythm between languages |
Frame-Synced .SRT + .VTT Subtitles Included | Returned automatically in the same call | Audio only (manual Whisper + typo fixing needed) | Raw audio bytes only |
| 7-Emotion Vocal Directing | happy, sad, angry, fearful, disgusted, surprised, neutral | Limited or unlabelled style sliders | Minimal prosody flags |
| Zero-Dependency Agent Integration | Native Remote HTTP MCP + 79-line STDIO bridge | Custom wrapper required | Custom SDK coding required |
Available MCP Tools (3 Tools)
1. synthesize_cantonese_tts
Synthesizes natural Hong Kong Cantonese and Konglish speech and returns the hosted .mp3 download URL alongside frame-aligned .srt and .vtt subtitle tracks.
- Key inputs:
text(string, required): Spoken Hong Kong Cantonese or bilingual Konglish script (1 to 5,000 characters).voice_id(string, optional): Voice identifier fromlist_cantonese_voices(defaults to flagship Hong Kong female host).emotion(string, optional):neutral|happy|sad|angry|fearful|disgusted|surprised.speed(number, optional): Playback speed multiplier (0.5to2.0, default1.0).
- Returns: Hosted
.mp3URL,.srtsubtitle content/URL,.vttsubtitle content/URL, character count billed, and remaining wallet balance.
2. list_cantonese_voices
Lists the curated Hong Kong Cantonese, Konglish bilingual, commercial promo, storytelling, and Studio VIP signature voices with gender, style tags, and recommended use cases so the AI agent can pick the best voice automatically.
3. check_character_wallet
Returns real-time PostgreSQL character wallet balance, active plan tier, and API readiness status before running batch jobs.
Quick Setup (60 Seconds)
- Audition voices free with zero login at https://cantonesetts.com (sign in free to receive +50 trial credits).
- Generate your
ct_live_...API key on the Developer Portal.
Option A: Direct Remote Streamable HTTP (Claude Code / Cursor / Windsurf)
No local package installation required:
{
"mcpServers": {
"cantonesetts": {
"type": "http",
"url": "https://cantonesetts.com/api/mcp",
"headers": {
"Authorization": "Bearer ct_live_YOUR_STUDIO_API_KEY"
}
}
}
}
Option B: Zero-Dependency Local STDIO Bridge (npx for Claude Desktop & Any MCP Host)
Uses index.mjs (79 lines of zero-dependency Node.js >= 18 standard library code, auditable in 30 seconds):
{
"mcpServers": {
"cantonesetts": {
"command": "npx",
"args": ["-y", "github:cantonesetts/cantonesetts-mcp"],
"env": {
"CANTONESETTS_API_KEY": "ct_live_YOUR_STUDIO_API_KEY"
}
}
}
}
Option C: Claude Code Plugin Marketplace Command
/plugin marketplace add cantonesetts/cantonesetts-mcp
Real-World Use Cases
- Faceless Instagram Reels, TikTok & YouTube Shorts Automation: Have Claude or Cursor draft a 45-second Hong Kong finance, property, food, or tech script in spoken Cantonese, call
synthesize_cantonese_tts, and hand editors a matched.mp3+.srtpair ready for CapCut. - Hong Kong E-Commerce & Agency Ad Variations: Batch-produce 10 A/B hook variations in
happyorsurprisedemotion for Meta & YouTube ads in under 2 minutes instead of booking studio reshoots. - Cantonese E-Learning, IVR & SaaS Product Walkthroughs: Generate consistent Konglish onboarding narration and accessible Traditional Chinese
.vttcaptions directly from product release notes.
Frequently Asked Questions (FAQ)
Does cantonesetts-mcp store or log my scripts locally?
No. index.mjs is a stateless 79-line JSON-RPC forwarder using only Node's built-in node:readline and fetch to reach https://cantonesetts.com/api/mcp over HTTPS.
Can it handle Hong Kong Cantonese mixed with English terms (Konglish)?
Yes. Voices are tuned for authentic Hong Kong bilingual phrasing such as startup, finance, retail, and agency terminology without awkward language-switching pauses.
Where can I read the full REST API & cURL documentation?
Full OpenAPI-style Markdown docs for both humans and LLMs are published at https://cantonesetts.com/api-docs.md and https://cantonesetts.com/llms.txt.
Official Links
- Web Studio & Instant Voice Audition: https://cantonesetts.com
- Online Cantonese TTS Workspace: https://cantonesetts.com/zh-HK/tts
- Developer API & MCP Keys: https://cantonesetts.com/zh-HK/developer
- Pricing & Never-Expiring HKD Character Packs: https://cantonesetts.com/zh-HK/billing
- Cantonese AI Voiceover Guides & Case Studies: https://cantonesetts.com/zh-HK/blog
- Support: hello@cantonesetts.com
License
MIT License. See LICENSE.
No installation packages available.