> ## 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.

# Prompt Kubit

> How to phrase questions for the Kubit MCP server: what a good prompt includes, examples from simple to advanced and tips for follow-ups.

This page covers how to phrase a question so the Kubit MCP server builds the report you want. It lists the parts of a good prompt, examples from simple to advanced and tips for follow-ups. Each report page has prompts specific to that report type.

## What a good prompt includes

A Kubit prompt names what to measure and over which time period. The Kubit MCP server fills in the rest with defaults, so add the other parts when the default isn't what you want.

| Part | What to say | Example |
| - | - | - |
| **Measure** | What to count or calculate, and on which events or spans | "average latency", "unique users who sent a message" |
| **Time period** | The date range | "last 30 days", "since Nov 1" |
| **Breakdown** | The field to split the results by | "by model name", "by tool" |
| **Filter** | Which events, spans or users to include | "production only", "where status is error" |
| **Report type** | When the measure alone doesn't make it clear | "as a funnel", "as retention by week" |
| **Chart type** | For Query reports, the visualization | "as a stacked bar", "as a KPI" |

Use the names of events and fields as they appear in your workspace. If you don't know a field's name, ask "Which field holds the value Premium?" and the assistant looks it up with `explain_field`.

## Examples by complexity

These prompts show how much detail the Kubit MCP server can take in one request.

| Complexity | Prompt |
| - | - |
| Simple | "How many traces came in this week?" |
| Medium | "Show me daily average latency by model name over the last 30 days, filtered to production" |
| Advanced | "Build a funnel from user prompt to tool call to response, broken down by model, with a 1-hour conversion window, last 14 days" |
| Find a report | "Find the Weekly Performance report" |
| Refresh a report | "Refresh the latency report" |
| Workspaces | "Create a new workspace called Production Monitoring" or "Switch to the staging workspace" |

## Prompts by report type

Each report page explains what that report needs in a prompt and lists examples.

| Report type | Prompt guidance |
| - | - |
| Query | [Prompt Kubit through MCP](https://learn.kubit.ai/product-analytics/reports/query.md#prompt-kubit-through-mcp) |
| Funnel | [Prompt Kubit through the MCP server](https://learn.kubit.ai/product-analytics/reports/funnel.md#prompt-kubit-through-the-mcp-server) |
| Path | [Prompt Kubit through the MCP server](https://learn.kubit.ai/product-analytics/reports/path.md#prompt-kubit-through-the-mcp-server) |
| Retention | [MCP prompt examples](https://learn.kubit.ai/product-analytics/reports/retention.md#mcp-prompt-examples) |
| Cohorts | [MCP prompt examples](https://learn.kubit.ai/product-analytics/reports/cohorts.md#mcp-prompt-examples) |
| Agent Observability data | [Concepts: MCP prompt examples](https://learn.kubit.ai/agent-observability/concepts.md#mcp-prompt-examples) |

## Tips

These tips cover the follow-ups people ask most often after the first report.

* **Ask for a refresh when the data looks old.** Saved reports can return cached results. "Refresh it" runs the report again on current data.
* **Ask for rows behind a number.** "Show me the traces with errors in the last hour" lists the matching traces, with a link to a CSV export of all of them.
* **Open the report in Kubit for chart settings.** The MCP server can't change number formats, units or colors. Every report it builds comes with a link to the report in Kubit.
* **Switch workspaces before you ask.** The MCP server works in one workspace at a time. Ask "Switch to the staging workspace" first, then ask your question.
* **Expect a new report when you change one.** Reports can't be edited through the MCP server. "Same report, but by week" builds a new report and leaves the original as it was.

## Related

* [MCP tools reference](https://learn.kubit.ai/ai-assistant/tools.md): which report types `create_report` builds and its limits.
* [Reports overview](https://learn.kubit.ai/product-analytics/reports/overview.md): what each report type answers.


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