# Connect the Omni MCP server to Unblocked to give AI agents live BI and semantic model context

URL: https://getunblocked.com/integrations/omni/

Unblocked connects to Omni’s MCP server so AI coding agents can query your Omni models, topics, and saved content live — then its Context Engine reconciles what they find with the code, pull requests, and conversations behind them.

---

## Omni integration details

- **Category:** Data & Analytics
- **Live-queried data:** dashboards, queries
- **Supported products:** Omni Analytics · Omni semantic models · Omni dashboards
- **Works with:** Claude Code, Cursor, Devin, GitHub Copilot, Codex, OpenCode, VS Code — via one MCP server connection
- **Maintained by:** Omni · verified by Unblocked
- **Content reviewed:** October 20, 2026
- **Website:** <https://omni.co>

## What the Omni integration adds

When a dashboard number looks wrong, the answer is split between Omni and the codebase. The model and topic definitions live in Omni, while the events, pipelines, and schema changes that feed them live in code, so an agent asked about a metric can see only half the picture. Omni’s MCP server exposes its models, topics, queries, and saved content to AI agents, and Unblocked connects to it once so every agent can ask Omni without its own setup.

This is a third-party MCP server: Omni hosts and maintains it, and Unblocked connects to it as a verified MCP server. Nothing is ingested or indexed — Unblocked calls the read-only tools you select at the moment a question needs them, so query results reflect your Omni models and data as they are now, under the permissions of the user who authorized the connection.

Wiring Omni’s MCP server straight into an agent gives it query results. Unblocked’s Context Engine reasons across those results and your other sources — following a shifted dashboard metric to the topic it is built on, the pull request that changed the underlying table, and the Slack thread where someone first flagged the drop — and returns one cited answer.

Once connected, any MCP-compatible coding agent — Claude Code, Cursor, Devin, GitHub Copilot, Codex — reaches Omni context through a single Unblocked MCP server connection.

### What you get

- **Queries through your semantic model** — Agents pick an Omni model and topic, then query it, so answers use the joins and definitions your data team already maintains instead of hand-written SQL against raw tables.
- **Saved dashboards and queries in reach** — Agents search your Omni dashboards and apps and run the saved queries inside them, so a question can start from the chart the team already trusts.
- **Read-only, tool-level control** — Unblocked offers only Omni’s read-only tools — nothing that edits dashboards, apps, or drafts. Omni admins also control which capabilities the server allows, and you choose which tools Unblocked may call from Settings → Data Sources.
- **Context Engine reasoning** — Omni results are reconciled with your code, pull requests, tickets, and conversations, so an unexpected number leads to the change that caused it — with citations.

## How to connect Omni to Unblocked

Prerequisites:

- An Unblocked account (free to start).
- An Omni organization where an admin has enabled AI, Omni Agent, and the MCP server in AI Hub, and an Omni user who can authorize through OAuth.
- An MCP-compatible coding agent (Claude Code, Cursor, Devin, etc.) to use the context in your editor.

### Step 1: Connect Omni to Unblocked

1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Data & Analytics select Omni.
2. The Omni MCP server URL is filled in for you. Choose OAuth, click Connect, and sign in to Omni to authorize Unblocked.
3. Once Unblocked discovers the server’s tools, select the read-only tools it may use and click Save Settings.

### Step 2: Install the Unblocked MCP server

On macOS or Linux, one command auto-detects and configures the supported agents on your machine:

```bash
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

On Windows, or when you prefer remote MCP, add the server manually using the configuration below or follow the manual install guide: <https://docs.getunblocked.com/unblocked-mcp/mcp-overview>

Claude Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth:

```bash
claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse
```

Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth:

```json
{
  "mcpServers": {
    "unblocked": {
      "url": "https://getunblocked.com/api/mcpsse"
    }
  }
}
```

Any MCP-compatible client (Devin, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse`

## Omni MCP server tools

Omni hosts and maintains this MCP server. Unblocked calls only the read-only tools you select, at the moment a question needs them:

- **`pickModel`** — Lists the Omni models available to the authorized user, with their IDs.
- **`pickTopic`** — Lists the topics in a model and picks the most relevant one for a question.
- **`getData`** — Runs a query against a chosen model and topic and returns the results.
- **`searchContent`** — Searches your Omni dashboards and apps.
- **`runSavedQuery`** — Runs a saved query from an Omni document by its ID and returns the results.
- **`searchOmniDocs`** — Searches Omni’s documentation and returns an answer with citations to specific pages.

## Connect Omni to Claude Code, Cursor, and other AI agents

To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Omni context, connect Omni to Unblocked and add the single Unblocked MCP server to your agent.

Unblocked acts as the MCP context layer for your Omni data, searching dashboards and queries alongside your other connected sources and returning cited results through these tools:

- **`context_research`** — Researches a question across your connected sources and calls the Omni tools you selected when models, dashboards, or query results are relevant, returning a synthesized answer with citations.
- **`context_get_urls`** — Fetches the full content behind URLs your agent encounters across connected sources — Jira, Linear, Notion, Confluence, Slack, GitHub, and more.

## Questions to ask an AI agent about Omni

Questions you (or your agent) can ask Unblocked about your Omni data:

- "Why did weekly signups drop on the growth dashboard, and did a recent pull request change the events table it reads from?"
- "Which Omni topic defines net revenue, and does it match the logic in our billing service?"
- "Run the saved churn query from the retention dashboard and tell me whether anyone has opened a ticket about the spike."
- "Before I rename this column, which Omni dashboards would break, and who discussed the change in Slack?"

## Omni integration FAQ

### What is the Omni MCP server?

The Omni MCP server is a remote Model Context Protocol server, hosted and maintained by Omni, that lets AI agents query Omni Analytics — picking a model and topic, running queries, searching dashboards and apps, and running saved queries, all under the signed-in user’s permissions. Unblocked connects to it as a verified MCP server, so every agent reaches it through one Unblocked connection.

### Can Unblocked edit my Omni dashboards or apps?

No. Omni’s server includes tools that draft dashboard changes and edit or publish apps, but Unblocked offers only its read-only tools for selection. Agents can query and read Omni content, never change it.

### Which Omni data can agents query?

Agents can query the models and topics the authorized user can access, search dashboards and apps, and run saved queries. Omni applies that user’s permissions to every call, and admins decide which capabilities — such as single-shot query generation — the server allows.

### How does this help when a dashboard metric changes?

An agent can query the metric through the Omni topic behind the dashboard, then use the Context Engine to find the pull request, schema change, or pipeline update that touched the underlying data and the conversation where the change was noticed.

### Does Unblocked index my Omni dashboards or query results?

No. Nothing from Omni is ingested or indexed. Unblocked calls Omni’s tools while it answers a question, so models, dashboards, and results reflect Omni at that moment.

## Related integrations

- [Snowflake](https://getunblocked.com/integrations/snowflake/) — A live schema wiki and read-only SQL access to your Snowflake databases, reconciled with your code, pull requests, and docs.
- [Fivetran](https://getunblocked.com/integrations/fivetran/) — Context Layer data from your warehouse from Fivetran’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed.
- [Amplitude](https://getunblocked.com/integrations/amplitude/) — Product analytics from Amplitude’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed.
- [GitHub](https://getunblocked.com/integrations/github/) — Repositories, pull requests, issues, discussions, and full code history — indexed, kept in sync on every push, and cited in answers.

## Get started with Unblocked

- Start a free trial: <https://getunblocked.com/dashboard/get-started>
- Pricing: <https://getunblocked.com/pricing/>
- All integrations: <https://getunblocked.com/integrations/>
