MCP setup
Audioworm exposes a Streamable HTTP MCP server for agents. Tools reuse the same organization-scoped services as the REST API. Auth is a Bearer API key — not OAuth.
Endpoint & auth
https://app.audioworm.fm/api/mcpMethods: GET, POST, DELETE. On every request:
Authorization: Bearer aw_…Create a key in Settings → API keys (owners and admins). Copy it immediately — it is shown only once.
Supported clients
Clients below support remote Streamable HTTP (or an honest bridge). Replace aw_… with your key. Prefer env-var interpolation where the client supports it.
Cursor
AI code editor with first-class remote MCP.
Where: Cursor Settings → Tools & MCP, or edit ~/.cursor/mcp.json (global) / .cursor/mcp.json (project).
{
"mcpServers": {
"audioworm": {
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}Claude (Desktop / web connectors)
Anthropic’s Claude apps; remote connectors over Streamable HTTP.
Where: Settings → Connectors → Add custom connector. Paste the MCP URL, then under Request headers set Authorization to Bearer aw_… (request-header auth is in beta).
{
"mcpServers": {
"audioworm": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.audioworm.fm/api/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer aw_..."
}
}
}
}If request headers are unavailable on your plan, use the mcp-remote stdio bridge below via ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) — Claude’s JSON config is stdio-only.
Claude Code
Anthropic’s CLI coding agent with native HTTP MCP.
Where: Project .mcp.json, ~/.claude.json, or claude mcp add --transport http …
{
"mcpServers": {
"audioworm": {
"type": "http",
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}CLI equivalent: claude mcp add --transport http audioworm https://app.audioworm.fm/api/mcp--header "Authorization: Bearer aw_…"
VS Code / GitHub Copilot
Copilot agent mode with workspace or user MCP config.
Where: Command Palette → “MCP: Open User Configuration” or add .vscode/mcp.json. Use Agent mode in Copilot Chat.
{
"servers": {
"audioworm": {
"type": "http",
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}Windsurf
Codeium’s Cascade agent with remote MCP support.
Where: Cascade → Manage MCPs → View Raw Config, or ~/.codeium/windsurf/mcp_config.json. Refresh after saving.
{
"mcpServers": {
"audioworm": {
"serverUrl": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}Use serverUrl (not url) for remote HTTP.
Zed
High-performance editor with built-in agent + remote MCP.
Where: Settings → AI → MCP Servers → Add Remote Server (or zed: open settings file).
{
"context_servers": {
"audioworm": {
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}Continue
Open-source IDE extension / CLI with streamable-http MCP.
Where: config.yaml mcpServers, or a block under .continue/mcpServers/.
mcpServers:
- name: audioworm
type: streamable-http
url: https://app.audioworm.fm/api/mcp
apiKey: aw_...apiKey is sent as Authorization: Bearer <value>. Alternatively use requestOptions.headers with the full Bearer header.
Cline
VS Code / JetBrains autonomous coding agent.
Where: Cline panel → MCP Servers → Configure MCP Servers (or Remote Servers tab).
{
"mcpServers": {
"audioworm": {
"type": "streamableHttp",
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
},
"disabled": false
}
}
}Type must be "streamableHttp" (camelCase). Omitting type falls back to legacy SSE.
Roo Code
VS Code agent (Cline fork) with its own MCP settings.
Where: Roo Code → Settings (gear) → MCP Servers → Edit Global MCP or Edit Project MCP (.roo/mcp.json).
{
"mcpServers": {
"audioworm": {
"type": "streamable-http",
"url": "https://app.audioworm.fm/api/mcp",
"headers": {
"Authorization": "Bearer aw_..."
}
}
}
}Type must be "streamable-http" (with hyphen). Separate from Cline’s config store.
ChatGPT (Developer mode)
OpenAI ChatGPT custom connectors for remote MCP.
Where: Settings → enable Developer mode, then Apps & connectors → create a developer-mode app with the MCP URL. Choose Token auth and paste aw_… (or Bearer aw_… if the UI expects the scheme).
Requires a paid ChatGPT plan with Developer mode. Remote HTTPS only — no local stdio. Token support can vary by workspace; if Token is unavailable, ChatGPT expects OAuth and cannot use a static Audioworm key without a bridge.
Codex CLI
OpenAI’s local coding agent with Streamable HTTP MCP.
Where: Settings → MCP servers, or ~/.codex/config.toml.
[mcp_servers.audioworm]
url = "https://app.audioworm.fm/api/mcp"
bearer_token_env_var = "AUDIOWORM_API_KEY"Set AUDIOWORM_API_KEY=aw_… in the environment (value without the Bearer prefix).
Bridge note (stdio-only hosts)
If a client only speaks stdio MCP, proxy with npx -y mcp-remote and pass --header Authorization:Bearer…. Prefer native url / serverUrl + headers when available.
Tools
list_projects/create_project/get_project/update_projectlist_voices/preview_voicestart_production— pay-as-you-go charge + enqueue ($0.001 per character); Checkout URL ($50 min) if no card on filecreate_production_checkout— hosted Checkout URL only (browser payment, $50 minimum)get_billing/create_billing_setup/create_billing_portallist_deliverables/request_deliverableget_chapter_download_url
Resources
Optional status snapshot: audioworm://project/{id}.
Scopes
projects:read— list / get projects and voicesprojects:write— create / update, preview, start production / checkout, billing setup, deliverable buildsaudio:read— chapter / deliverable downloads
Payment (pay-as-you-go)
- MCP & API: $0.001 per character — charged when
start_productionruns. - Owner saves a card in Settings → Billing. Keys never carry card numbers.
- Without a card: Checkout URL fallback (in-app Checkout has a $50 minimum).
See also the REST API reference.