omnidim mcp server

@omnidim-ai/mcp-server

Local stdio Model Context Protocol server for OmniDimension. Drive voice agents, dispatch calls, and manage knowledge bases from Claude, Cursor, Windsurf, or any MCP-compatible client.

Looking for the hosted OAuth variant? Use https://mcp.omnidim.io/mcp instead. The hosted server is the recommended path for Claude Desktop, Claude.ai, and any client that supports HTTP MCP.

Quick start

npx -y @omnidim-ai/mcp-server setup

Reuses a saved API key from ~/.config/omnidim/credentials if one exists, otherwise prompts for a new one and validates it. Then installs the server in any detected MCP client (Claude Code, Claude Desktop, Cursor, Windsurf). Get an API key at omnidim.io/api-management.

Manual install

Claude Code

claude mcp add omnidim -- npx -y @omnidim-ai/mcp-server

Claude Desktop, Cursor, Windsurf

Add this block to your MCP client config:

{
  "mcpServers": {
    "omnidim": {
      "command": "npx",
      "args": ["-y", "@omnidim-ai/mcp-server"],
      "env": {
        "OMNIDIM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Get your API key from omnidim.io/api-management.

Config file locations:

Client	Path
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

Tools

Surface	Tools
Agents	create, update, list, get, delete
Calls	dispatch, list logs, get log
Bulk calls	create, fetch, get, actions, cancel, live status
Knowledge base	list, upload, attach, detach, delete
Phone numbers	list, attach, detach, import (Twilio, Exotel, SIP)
Providers	list LLMs, list voices, list STT, list TTS
Reseller	child orgs, users, credits (reseller accounts only)

Full API reference: docs.omnidim.io.

Local development

git clone https://github.com/Omnidim/omnidim-mcp-server
cd omnidim-mcp-server
npm install
npm run build
OMNIDIM_API_KEY=sk_... npm start

Inspect tools and call them interactively:

OMNIDIM_API_KEY=sk_... npx @modelcontextprotocol/inspector node build/index.js

Telemetry

Anonymous usage data is sent to help us improve the package: package version, Node version, OS family, install count, session boots, tool names, and setup or crash outcomes as short error categories (e.g. config_write_error, http_500). No API keys, no tool inputs/outputs, no error messages, no file paths, no personal info.

Disable with:

npx -y @omnidim-ai/mcp-server telemetry disable

Full field-by-field breakdown and other opt-out options in TELEMETRY.md.

Troubleshooting

Run the diagnostics command to see versions, detected clients, backend reachability, and recent errors:

npx -y @omnidim-ai/mcp-server doctor

It never prints your API key. A local log of errors is kept at ~/.config/omnidim/logs/mcp.log (stays on your machine, never sent).

Reporting issues

See ISSUES.md for how to file bug reports, request features, or get help. Paste the doctor output into your report.

License

MIT