io.github.Omnidim/omnidim-mcp-server
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http omnidim-mcp-server 'https://mcp.omnidim.io/mcp'
{
"mcpServers": {
"omnidim-mcp-server": {
"type": "http",
"url": "https://mcp.omnidim.io/mcp"
}
}
}
@omnidim-ai/mcp-serverclaude mcp add omnidim-mcp-server -e 'OMNIDIM_API_KEY=<your omnidim_api_key>' -- npx -y @omnidim-ai/mcp-server@0.8.0
{
"mcpServers": {
"omnidim-mcp-server": {
"command": "npx",
"args": [
"-y",
"@omnidim-ai/mcp-server@0.8.0"
],
"env": {
"OMNIDIM_API_KEY": "<your omnidim_api_key>"
}
}
}
}
Environment variables
OMNIDIM_API_KEYrequired secret OmniDimension API key. Generate one at https://omnidim.io/api-management
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
@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
Frequently asked questions
What is io.github.Omnidim/omnidim-mcp-server?
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
How do I install io.github.Omnidim/omnidim-mcp-server?
It runs as a remote server. In Claude Code: claude mcp add --transport http omnidim-mcp-server 'https://mcp.omnidim.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.Omnidim/omnidim-mcp-server need an API key?
Yes. It expects OMNIDIM_API_KEY, which you set in its configuration.
Is io.github.Omnidim/omnidim-mcp-server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.Omnidim/omnidim-mcp-server?
It is published by Omnidim. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.