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](./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](./ISSUES.md) for how to file bug reports, request features, or get help. Paste the doctor output into your report.

License

[MIT](./LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Omnidim
• Source: Omnidim/omnidim-mcp-server
• License: MIT
• Homepage: https://omnidim.io

Install and usage instructions live in the source repository linked above.