@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.