About omnidim-mcp-server
omnidim-mcp-server connects MCP-compatible clients to OmniDimension for managing voice agents, calls, and related resources. Its tools cover individual and bulk calls, knowledge bases, phone numbers, and provider listings.
Key features
- 01Create and manage voice agents
- 02Dispatch and inspect calls
- 03Manage bulk call campaigns
- 04Manage knowledge bases and phone numbers
- 05List model, voice, STT, and TTS providers
Use cases
- 01Create or update a voice agent
- 02Dispatch calls and review call logs
- 03Upload and attach knowledge bases
- 04Manage phone numbers for voice agents
MCP support
The local stdio MCP server exposes OmniDimension tools to MCP clients. A hosted OAuth variant is also available at `https://mcp.omnidim.io/mcp`.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.omnidim.io/mcpclaude mcp add --transport http omnidim-omnidim https://mcp.omnidim.io/mcp{"mcpServers":{"omnidim-omnidim":{"type":"http","url":"https://mcp.omnidim.io/mcp"}}}Open in Cursor{"servers":{"omnidim-omnidim":{"type":"http","url":"https://mcp.omnidim.io/mcp"}}}Open in VS Code{"mcpServers":{"omnidim-omnidim":{"type":"http","url":"https://mcp.omnidim.io/mcp"}}}{"mcpServers":{"omnidim-omnidim":{"serverUrl":"https://mcp.omnidim.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README@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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.