io.github.Omnidim/omnidim-mcp-server
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
Open source Repository Open in the app JSON README (API)
About
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- omnidim
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.8.0
- Stars
- 7
- Open pull requests
- 5
- Last push
- 2026-09-03T12:02:12Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:09
- Updated
- 2026-08-29 03:02:09
- Origin id
io.github.Omnidim/omnidim-mcp-server
README
# @omnidim-ai/mcp-server
Local stdio Model Context Protocol server for [OmniDimension](https://omnidim.io). 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`](https://docs.omnidim.io/docs/mcp) instead. The hosted server is the recommended path for Claude Desktop, Claude.ai, and any client that supports HTTP MCP.
## Quick start
```bash
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](https://omnidim.io/api-management).
## Manual install
### Claude Code
```bash
claude mcp add omnidim -- npx -y @omnidim-ai/mcp-server
```
### Claude Desktop, Cursor, Windsurf
Add this block to your MCP client config:
```json
{
"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](https://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](https://docs.omnidim.io).
## Local development
```bash
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:
```bash
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:
```bash
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:
```bash
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)