{"openapi":"3.1.0","info":{"title":"Voicebooth API","version":"0.1.0","description":"A fully local voiceover/narration recording setup guide: mic technique and distance, budget room-treatment tiers, breath-control and pacing tips by content type, and common audio-cleanup steps explained as technique.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://voicebooth.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/voicebooth/docs"},"termsOfService":"https://connectorbay.com/voicebooth/terms"},"servers":[{"url":"https://voicebooth.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/voicebooth/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/mic_type_info":{"post":{"operationId":"mic_type_info","summary":"How a dynamic or condenser microphone works, its characteristics, typical use, and recommended recording","description":"How a dynamic or condenser microphone works, its characteristics, typical use, and recommended recording\n    distance. Use for \"should I use a dynamic or condenser mic\", \"how far from a condenser mic should I sit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mic_type":{"description":"'dynamic' or 'condenser'.","examples":["condenser"],"title":"Mic Type","type":"string"}},"required":["mic_type"],"title":"mic_type_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/mic_technique_guide":{"post":{"operationId":"mic_technique_guide","summary":"Mic technique: proximity effect, off-axis angle to reduce plosives/sibilance, pop-filter distance, staying","description":"Mic technique: proximity effect, off-axis angle to reduce plosives/sibilance, pop-filter distance, staying\n    at a consistent distance, and gain staging targets. Use for \"why does my voice sound boomy\", \"how do I stop\n    popping the mic\", \"what level should I record at\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"mic_technique_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/room_treatment_guide":{"post":{"operationId":"room_treatment_guide","summary":"DIY room-treatment tips at three budget tiers, plus the general absorption-vs-soundproofing principle. Use","description":"DIY room-treatment tips at three budget tiers, plus the general absorption-vs-soundproofing principle. Use\n    for \"how do I treat my room for recording with no budget\", \"how do I stop echo in my recordings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"budget_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'no_budget', 'low_budget', or 'mid_budget'; omit for all three.","title":"Budget Tier"}},"title":"room_treatment_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/breath_control_tips":{"post":{"operationId":"breath_control_tips","summary":"Breath-control tips for narration: diaphragm breathing, marking breath points, taking bigger breaths before","description":"Breath-control tips for narration: diaphragm breathing, marking breath points, taking bigger breaths before\n    long sentences, and reducing audible breath noise. Use for \"how do I stop gasping on mic\", \"how do I control my\n    breathing while narrating\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"breath_control_tipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/pacing_guide":{"post":{"operationId":"pacing_guide","summary":"Words-per-minute pacing ranges and delivery notes for 7 content types: audiobook, commercial, e-learning,","description":"Words-per-minute pacing ranges and delivery notes for 7 content types: audiobook, commercial, e-learning,\n    explainer video, IVR/telephony, podcast narration, documentary. Use for \"what pace should an audiobook be\n    read at\", \"how fast should a commercial VO be\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A content type; omit to see all.","examples":["audiobook"],"title":"Content Type"}},"title":"pacing_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/script_marking_guide":{"post":{"operationId":"script_marking_guide","summary":"Standard script-annotation marks for breaths, pauses, emphasis, and director's notes, plus how to mark a","description":"Standard script-annotation marks for breaths, pauses, emphasis, and director's notes, plus how to mark a\n    script before recording. Use for \"how do I mark up a voiceover script\", \"what does a double slash mean in a\n    script\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"script_marking_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/audio_cleanup_steps":{"post":{"operationId":"audio_cleanup_steps","summary":"Explains common audio-cleanup techniques — noise reduction, de-essing, EQ cleanup, compression, mouth-click","description":"Explains common audio-cleanup techniques — noise reduction, de-essing, EQ cleanup, compression, mouth-click\n    removal — as technique to apply in your own editor. This tool never touches actual audio. Use for \"how does\n    noise reduction work\", \"how do I de-ess a recording\", \"what does compression do to voiceover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"step":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A cleanup step; omit to see all.","examples":["de_essing"],"title":"Step"}},"title":"audio_cleanup_stepsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/common_mistakes":{"post":{"operationId":"common_mistakes","summary":"Frequent voiceover/narration recording mistakes, from gain staging to mic distance to over-processing. Use","description":"Frequent voiceover/narration recording mistakes, from gain staging to mic distance to over-processing. Use\n    for \"what mistakes do beginners make recording voiceover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_mistakesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/preflight_checklist":{"post":{"operationId":"preflight_checklist","summary":"A pre-recording checklist covering room, mic setup, gain, room tone, and script prep. Use for \"what should","description":"A pre-recording checklist covering room, mic setup, gain, room tone, and script prep. Use for \"what should\n    I check before I start recording\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"preflight_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/voicebooth_glossary":{"post":{"operationId":"voicebooth_glossary","summary":"Definitions of voiceover/recording terms: proximity effect, plosive, sibilance, room tone, pop filter, gain","description":"Definitions of voiceover/recording terms: proximity effect, plosive, sibilance, room tone, pop filter, gain\n    staging, noise floor, de-esser, high-pass filter, dry/wet mix. Use for \"what's room tone\", \"what's a de-esser\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"voicebooth_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}