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.

The quickest way to configure MCP is via the CLI setup command: vr setup. It automatically configures the MCP server for your editor. See the VoiceRun CLI overview for details.

MCP Server URL:

https://api.voicerun.com/v1/mcp

Claude Code#

Official Documentation

Global Configuration#

Available in all projects.

~/.claude.json:

{
  "mcpServers": {
    "voicerun": {
      "type": "http",
      "url": "https://api.voicerun.com/v1/mcp"
    }
  }
}

Project-Specific Configuration#

Add to an individual project only.

.mcp.json (in project root):

{
  "mcpServers": {
    "voicerun": {
      "type": "http",
      "url": "https://api.voicerun.com/v1/mcp"
    }
  }
}

CLI#

You can also add the server via command line:

claude mcp add --transport http voicerun https://api.voicerun.com/v1/mcp

Cursor#

Official Documentation

Cursor 1.0+ supports native HTTP MCP servers.

Global Configuration#

Available in all projects.

~/.cursor/mcp.json:

{
  "mcpServers": {
    "voicerun": {
      "url": "https://api.voicerun.com/v1/mcp"
    }
  }
}

Project-Specific Configuration#

Add to an individual project only.

.cursor/mcp.json (in project root):

{
  "mcpServers": {
    "voicerun": {
      "url": "https://api.voicerun.com/v1/mcp"
    }
  }
}

Settings UI#

You can also configure MCP servers via the Cursor UI:

1. Open Settings → Features → MCP Servers
2. Click Add new MCP server
3. Enter the server URL: https://api.voicerun.com/v1/mcp

Codex#

Official Documentation

Global Configuration#

~/.codex/config.toml:

[mcp_servers.voicerun]
url = "https://api.voicerun.com/v1/mcp"

Project-Specific Configuration#

.codex/config.toml (in project root, trusted projects only):

[mcp_servers.voicerun]
url = "https://api.voicerun.com/v1/mcp"

CLI#

You can also add the server via command line:

codex mcp add voicerun --url https://api.voicerun.com/v1/mcp

ChatGPT#

Official Documentation

ChatGPT supports MCP servers via the Connectors feature. Available on Pro, Plus, Team, Enterprise, and Edu plans.

Settings UI#

1. Open Settings → Connectors
2. Click Create
3. Enter the server URL: https://api.voicerun.com/v1/mcp
4. Name it "VoiceRun"
5. Click Save

Enable Developer Mode (Recommended)#

For full MCP tool access (not just search/fetch), enable Developer Mode:

1. Go to Settings → Connectors → Advanced
2. Enable Developer mode

Note: ChatGPT only supports remote HTTPS servers.

Claude Desktop#

Official Documentation

Settings UI (Recommended)#

The easiest way to add MCP servers in Claude Desktop is via the Connectors UI:

1. Open Settings → Connectors
2. Click Add custom connector
3. Enter the server URL: https://api.voicerun.com/v1/mcp
4. Click Add

To enable the connector in a conversation, click the + button in the chat interface, then Connectors, and toggle VoiceRun on.

Note: Custom connectors are available on Pro, Max, Team, and Enterprise plans.

Config File#

Alternatively, you can configure via the config file. Claude Desktop requires the mcp-remote bridge for HTTP servers.

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

{
  "mcpServers": {
    "voicerun": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.voicerun.com/v1/mcp"]
    }
  }
}

Restart the Claude Desktop app after saving.

Windsurf#

Official Documentation

Global Configuration#

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "voicerun": {
      "serverUrl": "https://api.voicerun.com/v1/mcp"
    }
  }
}

Settings UI#

You can also configure MCP servers via the Windsurf UI:

1. Open Windsurf Settings → Cascade → MCP Servers
2. Click Add Server → Add custom server
3. Enter the server URL: https://api.voicerun.com/v1/mcp