> ## Documentation Index
> Fetch the complete documentation index at: https://learn.kubit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kubit MCP server

> The Kubit MCP server lets AI assistants such as Cursor, Codex and ChatGPT build Kubit reports, inspect traces and set up workspaces from a chat.

The Kubit MCP server connects an AI assistant to your Kubit workspace over the Model Context Protocol. With it connected, you ask Claude, Cursor, Codex or another MCP client a question in plain language, and the assistant builds the Kubit report, runs it and returns the results with a link to the report in Kubit.

The server works with Agent Observability and Product Analytics data. It reads the same workspaces, reports and permissions you have in the Kubit app.

## Server URL

The Kubit MCP server URL is `https://agent.kubit.ai/mcp`. It uses the streamable HTTP transport, so it runs in Kubit's cloud and needs nothing installed on your machine. [Connect your AI assistant](https://learn.kubit.ai/ai-assistant/connect.md) has the setup for each client.

## What the MCP server can do

The Kubit MCP server exposes 11 tools. Your assistant picks the tool, so you rarely name one. [MCP tools reference](https://learn.kubit.ai/ai-assistant/tools.md) lists every tool with its inputs and limits.

| Task | Example prompt | Tools |
| - | - | - |
| Build and run a report | "Show me daily average latency by model over the last 30 days" | `create_report` |
| Find, open or refresh a saved report | "Refresh the Weekly Performance report" | `get_report` |
| List the traces, sessions or events behind a number | "Traces with errors in the last hour" | `inspect` |
| Look up a field or a value | "Which field holds the value Premium?" | `explain_field` |
| Publish part of a report for reuse | "Publish this report's filter as Production Traffic" | `publish_component` |
| Recreate a dashboard built in Claude in Kubit | "Save this dashboard to Kubit" | `import_dashboard` |
| Create a workspace and an API key | "Create a workspace called Production Monitoring" | `workspace_create`, `workspace_mint_key` |
| Pick or change the workspace | "Switch to the staging workspace" | `init`, `switch` |
| Contact Kubit support | "Tell Kubit support my funnel report fails" | `help` |

## What the MCP server can't do

The Kubit MCP server builds Query, Funnel, Path, Retention, Inspection and Agent flow reports. Build these in the Kubit app instead:

| Not available through the MCP server | Where to do it |
| - | - |
| Data Table and Significance reports | Kubit app. [Data Table](https://learn.kubit.ai/product-analytics/reports/data-table.md) and [Significance](https://learn.kubit.ai/product-analytics/reports/significance.md) pages |
| Chart settings such as number formats, units and colors | Kubit app. [Chart settings](https://learn.kubit.ai/product-analytics/reports/query/chart-settings.md) |
| Creating or editing a warehouse model | The Modeler agent. [Modeler](https://learn.kubit.ai/warehouses/modeler.md) |
| Deleting reports, dashboards or published components | Kubit app |

## Sign-in and permissions

The Kubit MCP server signs you in with OAuth in your browser, using your Kubit account. The assistant sees the same organizations, workspaces and data you see in the Kubit app, with the same permissions.

Sign-in doesn't ask for an organization. After you sign in, the assistant starts in your last-used workspace. To change it, ask the assistant to switch workspaces, or run `/kubit-connect` if you use the Kubit plugin for Claude Code or Cursor.

## Related

> [card] [Connect your AI assistant](https://learn.kubit.ai/ai-assistant/connect.md)
>
> Setup for Claude Code, Cursor, Claude, Codex and other MCP clients.

> [card] [MCP tools reference](https://learn.kubit.ai/ai-assistant/tools.md)
>
> Every tool, its inputs and its limits.

> [card] [Prompt Kubit](https://learn.kubit.ai/ai-assistant/prompting.md)
>
> How to phrase questions so the MCP server builds the right report.

> [card] [Kubit skills](https://learn.kubit.ai/ai-assistant/skills.md)
>
> Slash commands for reports, traces and regressions in Claude Code and Cursor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.