🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →
@kolbo/mcp
Advanced tools
@kolbo/mcp - npm Package Compare versions
| # Voice / Text-to-Speech (`generate_speech`) — full style & option reference | ||
| `generate_speech` turns text into spoken audio. Every voice belongs to a | ||
| **provider** (ElevenLabs, DeepDub, MiniMax, Google/Gemini, OpenAI, Zonos). Each | ||
| provider exposes its own expressive controls. You may pass any control on any | ||
| call — **the engine silently ignores controls that don't apply to the chosen | ||
| voice's provider**, so you never need to branch on provider yourself. | ||
| ## Pick the voice first | ||
| Call `list_voices` (filter by `provider`, `language`, `gender`) and pass the | ||
| returned `voice_id` — or a display name like `"Rachel"`. Cloned/custom voices | ||
| resolve by name too. The voice determines the provider, which determines which | ||
| controls below take effect. | ||
| ## Core params (all providers) | ||
| | Param | Type | Notes | | ||
| |---|---|---| | ||
| | `text` | string (required) | The words to speak. | | ||
| | `voice` | string | Voice id or display name. Default `"Rachel"`. | | ||
| | `model` | string | From `list_models type="text_to_speech"`. Default `eleven_v3`. Usually inferred from the voice — only needed to force a specific engine. | | ||
| | `language` | string | BCP-47 code, e.g. `"en-US"`, `"he-IL"`, `"es-ES"`. | | ||
| | `speaking_speed` | number | `0.5` (slow) – `2.0` (fast). Default `1.0`. Applies to ElevenLabs / OpenAI / Google. | | ||
| | `project_id` | string | Scope into a project (see Projects rules). | | ||
| ## Expressive style / emotion (provider-specific) | ||
| | Param | Provider(s) | Values / notes | | ||
| |---|---|---| | ||
| | `style_instructions` | **Google / Gemini** | Free-form natural-language direction, e.g. `"whisper conspiratorially, slightly amused"`, `"excited sports announcer"`. Max 500 chars. | | ||
| | `selected_style` | **DeepDub**, MiniMax | Preset style. DeepDub: `reading`, `conversational`, `angry`, `breathy`, `panic`, `amused`, `sad`, `whisper`, `singing`, `shout`, `scream`, `mumbling`, `excited`. | | ||
| | `emotion` | **MiniMax** | `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `calm`, `fluent`, `whisper`. | | ||
| ## ElevenLabs voice settings | ||
| | Param | Range | Default | Effect | | ||
| |---|---|---|---| | ||
| | `similarity_boost` | 0–1 | 0.75 | Higher hews closer to the source voice. | | ||
| | `style` | 0–1 | 0.5 | Style exaggeration — higher is more expressive/dramatic. | | ||
| | `use_speaker_boost` | bool | true | Speaker-clarity boost. | | ||
| ## DeepDub controls | ||
| | Param | Range | Default | Effect | | ||
| |---|---|---|---| | ||
| | `variance` | 0–1 | 0.2 | More variation / takes. | | ||
| | `tempo` | 0–2 | 1.0 | Pacing multiplier. | | ||
| | `promptBoost` | bool | true | Higher fidelity to the text. | | ||
| | `seed` | int | — | Reproducibility (same seed + inputs → same output). Also honored by Zonos. | | ||
| | `accentControl` | object | — | `{ accentBaseLocale, accentLocale, accentRatio }` — blend an accent. Provide BOTH `accentBaseLocale` (e.g. `"en-US"`) and `accentLocale` (e.g. `"en-GB"`); `accentRatio` 0–1 (default 0.5). | | ||
| | `voiceTitle` | string | — | Display title for a custom/cloned voice. | | ||
| ## MiniMax fine controls | ||
| | Param | Range | Default | Effect | | ||
| |---|---|---|---| | ||
| | `minimax_pitch` | −12 … 12 | 0 | Pitch shift. | | ||
| | `minimax_vol` | 0–10 | 1 | Volume. | | ||
| | `minimax_intensity` | — | — | Voice intensity. | | ||
| | `minimax_timbre` | — | — | Voice timbre. | | ||
| ## Examples | ||
| Neutral ElevenLabs read: | ||
| ``` | ||
| generate_speech(text="Welcome to Kolbo.", voice="Rachel") | ||
| ``` | ||
| Whispered, conspiratorial Gemini delivery: | ||
| ``` | ||
| generate_speech(text="Meet me at midnight.", voice="Kore", | ||
| style_instructions="whisper conspiratorially, slow and breathy") | ||
| ``` | ||
| Angry DeepDub take, faster: | ||
| ``` | ||
| generate_speech(text="Get out of my house!", voice="<deepdub voice>", | ||
| selected_style="angry", tempo=1.2) | ||
| ``` | ||
| Excited MiniMax with pitch/volume tweaks: | ||
| ``` | ||
| generate_speech(text="We won the championship!", voice="<minimax voice>", | ||
| emotion="happy", minimax_pitch=3, minimax_vol=6) | ||
| ``` | ||
| British-accented DeepDub blend: | ||
| ``` | ||
| generate_speech(text="Good evening.", voice="<deepdub voice>", | ||
| accentControl={ accentBaseLocale: "en-US", accentLocale: "en-GB", accentRatio: 0.7 }) | ||
| ``` | ||
| ## Credits | ||
| ~5 credits per 100 characters for most TTS models (Zonos ~3; voice design/clone | ||
| ~30 flat). Charged only on success. Use `check_credits` once per conversation. |
+1
-1
| { | ||
| "name": "@kolbo/mcp", | ||
| "version": "1.43.0", | ||
| "version": "1.44.0", | ||
| "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code", | ||
@@ -5,0 +5,0 @@ "main": "src/index.js", |
+4
-4
@@ -130,7 +130,7 @@ # @kolbo/mcp | ||
| | `generate_creative_director` | One brief → N coordinated scenes (image or video) | | ||
| | `generate_music` | Text (+ optional lyrics) → song | | ||
| | `generate_speech` | Text + voice → spoken audio | | ||
| | `generate_sound` | Text → sound effect | | ||
| | `generate_music` | Text (+ optional lyrics) → song. Style, title, negative tags, length, and Suno fine-controls (style weight, weirdness, audio weight, persona / singing voice) | | ||
| | `generate_speech` | Text + voice → spoken audio. Full expressive/style control: free-form voice direction (Google/Gemini), preset styles + emotions (DeepDub / MiniMax), speed, and per-provider voice settings (ElevenLabs stability/similarity/style, DeepDub accent/variance/tempo, MiniMax pitch/volume/intensity/timbre) | | ||
| | `generate_sound` | Text → sound effect. Duration, prompt influence, and per-provider controls (Stable Audio guidance, Kie loop/tempo/key, Seed-Audio voice/speed/volume/pitch + reference audio/image) | | ||
| | `generate_3d` | Text or reference images → 3D model (GLB/FBX/OBJ/USDZ) | | ||
| | `transcribe_audio` | Audio/video URL or file → text + SRT subtitles | | ||
| | `transcribe_audio` | Audio/video URL or file → text + SRT subtitles. Language, speaker diarization, audio-event tagging, and SRT formatting (words/line, lines/subtitle, caption stretch) | | ||
@@ -137,0 +137,0 @@ Every image/video/creative-director tool accepts `visual_dna_ids` and `moodboard_id` for character/style consistency across outputs — you can compose `create_visual_dna` → `generate_image` (with the DNA applied server-side) in a single agent turn. `generate_creative_director` also accepts `moodboard_ids` plural for blending. |
+4
-3
@@ -106,5 +106,5 @@ --- | ||
| | `generate_lipsync` | Lipsync audio to an image or video face. | | ||
| | `generate_music` | Music generation (Suno + variants). | | ||
| | `generate_speech` | TTS. Use `list_voices` to pick a voice. | | ||
| | `generate_sound` | Sound effects. | | ||
| | `generate_music` | Music generation (Suno + variants). Controls: `style`, `title`, `lyrics`, `instrumental`, `vocal_gender`, `negative_tags`, `duration_seconds`, plus Suno fine-controls (`style_weight`, `weirdness`, `audio_weight`, `persona_id`, `singing_dna_id`/`singing_voice_id`). | | ||
| | `generate_speech` | TTS. Use `list_voices` to pick a voice, then steer delivery with per-provider style/emotion controls — see `references/models/voice-tts.md`. | | ||
| | `generate_sound` | Sound effects. Controls: `duration`, `prompt_influence`, plus provider-specific `cfg_strength` (Stable Audio), `sound_loop`/`sound_tempo`/`sound_key` (Kie), and Seed-Audio `seed_*` params. | | ||
| | `generate_3d` | 3D models from text / single image / multi-view. Returns GLB/FBX/OBJ/USDZ. | | ||
@@ -166,2 +166,3 @@ | ||
| - Never auto-select from "Named-only" section. | ||
| - **ALWAYS pass an explicit `model` — never omit it.** Omitting routes to the backend "Smart Select" auto-router, which we deliberately avoid: it hides the model choice and the generation used to show just "Auto" instead of the model that ran. YOU pick the specific model (steps above); only omit `model` when the user explicitly asks for auto-pick, or for chat media analysis (video/audio `media_urls`, which routes to Gemini vision). | ||
| 4. **Validate inputs** against model caps — see `references/workflows/cost-and-validation.md`. | ||
@@ -168,0 +169,0 @@ 5. **How calls work**: each tool blocks until generation is fully complete. Images: seconds. Video: minutes. Multiple tool calls in one response run concurrently. On hosts with live widgets the tool instead returns `submitted` instantly — the card updates on its own; you only need `get_generation_status` when a follow-up step needs the output URLs. |
Sorry, the diff of this file is too big to display
New alerts
URL strings
Supply chain riskPackage contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.
Fixed alerts
URL strings
Supply chain riskPackage contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.
Improved metrics
- Total package byte prevSize
708655
2.1%- Number of package files
60
1.69%- Lines of code
7419
1.09%No dependency changes