MCP Integration

VoiceRun provides an MCP (Model Context Protocol) server that allows MCP clients to interact with the VoiceRun API.

All documentation you find here is also available via the MCP server.

Setup#

1. Create an API Key#

Generate a VoiceRun API key here

2. Configure Your API Key#

Add to your shell profile:

export VOICERUN_API_KEY="<YOUR_API_KEY>"

3. Configure Your MCP Client#

Choose your client below and follow the setup instructions.

Claude Code#

Global Configuration#

Available in all projects.

~/.claude.json:

{
  "mcpServers": {
    "voicerun": {
      "type": "http",
      "url": "https://api.primvoices.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${VOICERUN_API_KEY}"
      }
    }
  }
}

Project-Specific Configuration#

Add to an individual project only.

~/.claude.json:

{
  "projects": {
    "/path/to/target/project/": {
      "mcpServers": {
        "voicerun": {
          "type": "http",
          "url": "https://api.primvoices.com/v1/mcp",
          "headers": {
            "Authorization": "Bearer ${VOICERUN_API_KEY}"
          }
        }
      }
    }
  }
}

Cursor#

Global Configuration#

Available in all projects.

~/.cursor/mcp.json:

{
  "mcpServers": {
    "voicerun": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.primvoices.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${VOICERUN_API_KEY}"
      ],
      "env": {
        "VOICERUN_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Project-Specific Configuration#

Add to an individual project only.

/path/to/target/project/.cursor/mcp.json:

{
  "mcpServers": {
    "voicerun": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.primvoices.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${VOICERUN_API_KEY}"
      ],
      "env": {
        "VOICERUN_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Codex#

Codex does not currently support runtime environment variable expansion.

~/.codex/config.toml:

[mcp_servers.voicerun]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://api.primvoices.com/v1/mcp",
  "--header",
  "Authorization: Bearer ${VOICERUN_API_KEY}"
]

[mcp_servers.voicerun.env]
VOICERUN_API_KEY = "<YOUR_API_KEY>"

Claude Desktop#

Claude Desktop does not currently support runtime environment variable expansion.

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "voicerun": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.primvoices.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${VOICERUN_API_KEY}"
      ],
      "env": {
        "VOICERUN_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Restart the Claude Desktop app after saving.