Overview
Connect Claude, ChatGPT, Cursor, and any MCP-compatible client to your OmniDimension account. Hosted OAuth at mcp.omnidim.io, or local stdio via the npm package.
The Model Context Protocol lets AI clients call tools on your behalf. OmniDimension ships two MCP entry points to the same set of tools (agents, calls, bulk calls, phone numbers, knowledge base, providers):
Hosted (cloud, OAuth)
https://mcp.omnidim.io/mcp. Add as a custom MCP server in Claude Desktop, Claude.ai, Cursor, VS Code, Codex. OAuth 2.1 sign-in, no API key handling on your side.
Local (npm, stdio)
@omnidim-ai/mcp-server runs as a stdio child process from your editor. Bearer API key in the env block. Use for CI, automation, or stdio-only clients.
Which one should I use?
| You're using... | Use this |
|---|---|
| Claude Desktop, Claude.ai web | Hosted |
| Claude Code | Hosted (one command) |
| Cursor, VS Code, Windsurf | Hosted. These clients speak HTTP MCP natively. |
| Codex (CLI, IDE, ChatGPT desktop app) | Hosted (one command) |
| ChatGPT custom connectors | Hosted |
| CI, scripts, headless automation | Local |
| An MCP client that only speaks stdio | Local |
If you are not sure, start with the hosted option. It is the path we recommend for everyone shipping interactive AI experiences.
What you can do over MCP
The tools are generated from the same OpenAPI spec as the API reference. The categories:
- Agents. List, create, update, delete, get, and manage versions.
- Calls. Dispatch outbound calls, fetch call logs and transcripts.
- Bulk calls. Create campaigns, monitor live status, cancel.
- Phone numbers. Search the shop, buy, release, list, attach to agents, and import from Twilio, Exotel, or SIP.
- Knowledge base. Upload files, attach to agents.
- Providers. List available LLMs, voices, STT, and TTS engines.
Two groups are deliberately left off, and stay available on the REST API and in both SDKs:
- Reseller operations. They act on other people's accounts, several move
money, and the verification ones relay identity documents. The
user_idparameter is stripped from the phone number tools for the same reason, so a tool call can only ever spend your own balance. - Simulations and the prompt-enhancement helper. Simulations are not documented or stable enough to sit behind an LLM yet.
How sign-in works
The hosted entry point uses a standard browser sign-in. Click connect in your MCP client, approve OmniDimension in the browser, and you're done. Tokens are scoped to your account and can be revoked any time from omnidim.io/api-management.
The local entry point uses an API key from your account. Drop it in the env block of your client config and the server uses it for every call.
See privacy and telemetry for what each server sees, what we log, and what we never store.
Open source
Both servers are public on GitHub:
omnidim-mcp-cloud(Apache 2.0). Hosted OAuth + HTTP server (FastAPI, Python).omnidim-mcp-server(MIT). Local stdio server, npm-distributed (TypeScript).
Issues and PRs welcome on both.