create_report builds, workspace context, cached results and limits. Your assistant calls these tools for you. The parameter names matter when you build your own MCP client or read a tool call in your assistant’s log.
When to use
Tools
The Kubit MCP server has 15 tools. Every tool exceptinit and switch needs a wsctx workspace token. Workspace context explains it. Every client gets all 15 tools. A tool your workspace or organization can’t use returns an error when called.
Tool Inputs
| Input | Tool | Values |
|---|---|---|
kind | create_report, get_report_instructions | query, dataTable, funnel, path, activity, grid, agentFlow, retention, inspection or significance. get_report_instructions also takes cohort. Report types explains each. |
definition | create_report | The report as JSON, following the schema get_report_instructions returns for its kind |
cohorts | create_report | Cohorts that only this report uses, each under a key the assistant chooses. The result gives each cohort’s ID for later reports. |
basedOnReportId | create_report | The ID of a report to change. The new report keeps that report’s chart settings and becomes its next version. It has to be the same kind. |
rows | get_report | Reads a page of the report’s rows instead of its summary: offset (default 0) and limit (default 50, at most 100) |
where, columns | get_report | where keeps only rows whose column equals a value or one of a list of values, such as { "Series": "Germany" }. columns returns only the named columns, in that order. Neither works on a grid. |
kind | publish_component | FILTER, MEASURE, VIRTUAL_EVENT, BINNING or COHORT |
selector | publish_component | Which candidate to publish when the report has several: a measure variable such as A, a binning’s field name, a cohort segment’s name, or FILTER for the report’s cohort filter |
name | publish_component | A new name creates a component. A name that holds the same definition returns that component unchanged. A name that holds a different definition adds a new version to it. |
pipelineType | workspace_create | AGENT (default) for agent traces, or BEHAVIOR for product events. Set at creation and can’t be changed. BEHAVIOR has to be turned on for your organization. |
action, target | memory | read returns both stores. update changes one store, named in target as workspace or user. init and switch already return both stores. |
operations | memory | 1 to 10 changes, each add, patch or remove, applied together or not at all. patch and remove find the entry by a unique part of its text. An entry marked [locked] was set by a person in Kubit and can’t be changed. |
requestType | help | BUG, FEEDBACK or QUESTION. isUrgent applies to BUG only. |
tiles | import_dashboard | 1 to 20 tiles in display order, each a reportId and an optional title |
Example Prompts
“Which field holds the value gpt-4o-mini?”
“Publish this report’s filter as Production Traffic”
“Remember that our production traffic is environment = prod”
Report Types
The assistant picks the report kind and writes the report as JSON. It reads the kind’s rules withget_report_instructions first, then sends the report to create_report. create_report builds 10 kinds:
Availability: Significance reports need the Significance feature for your organization. Without it,
create_report returns Significance reports are not enabled for this organization. A workspace that can’t draw an Agent flow report returns This workspace cannot draw an Agent Flow report.
When the server rejects a definition, create_report returns the errors without running the report. The assistant fixes the definition and calls create_report again. The server doesn’t retry on its own.
If the same definition ran in the last 6 hours, create_report reuses that data instead of querying again, and the result says when the data was computed.
To change a report, the assistant opens it with get_report, edits the definition JSON it returns and sends the result to create_report with basedOnReportId.
Example Prompts
“Build a funnel from user prompt to tool call to response, broken down by model, with a 1-hour conversion window, last 14 days”
“Show the agent flow across our traces over the last 14 days”
“List the traces with an Exception in the last hour”
Workspace Context
Every Kubit MCP session works in one organization and workspace.init picks your last-used workspace and returns a wsctx token for it. The assistant passes the token on every later tool call.
| Behavior | Details |
|---|---|
| Where the token comes from | init, switch or workspace_create |
| Changing workspace | switch returns a new token. Use it on every later call. |
| Expiry | The token doesn’t expire |
| Lost access | Kubit checks your access on every call. If you lose access to the workspace, calls fail until the assistant runs init or switch. |
| Malformed or unknown token | Invalid session token. Call init to obtain a new one. |
Example Prompts
“Which Kubit workspace am I connected to?”
“Switch to the staging workspace”
Cached Results
get_report returns a report’s last results when they’re cached. The response says the data came from cache and gives the time it was cached. To get current data, ask the assistant to refresh the report. It calls get_report with refresh set, which runs the report again.
A refresh waits up to 50 seconds. If the report is still running after that, the response says so and tells the assistant to call get_report again later, without refresh.
Example Prompts
“Refresh the latency report”
“Open the Weekly Performance report with today’s data”
Limits
| Constraint | Value |
|---|---|
Reports returned by a get_report search or recent list | 10 |
Sample rows in a create_report result | 20 |
Rows in one get_report page | 50 by default, at most 100 |
Reuse of an identical create_report definition | Data computed in the last 6 hours |
get_report refresh wait | 50 seconds |
help wait for a support reply | About 20 seconds. After that, the reply goes to your email. |
import_dashboard tiles | 1 to 20 |
import_dashboard dashboard name | 50 characters |
import_dashboard tile title | 80 characters |
publish_component description | 2,048 characters |
workspace_mint_key note | 1 to 255 characters |
| Lumos memory entry | 300 characters |
memory changes per call | 1 to 10 |
workspace_mint_key on an example workspace | Not supported |
| Deleting a published component | Not supported through the MCP server. A published component is visible to everyone in the workspace. |
Related
- Kubit MCP server: what the server does and what it can’t do.
- Connect your AI assistant: setup for each client.
- Import a dashboard from Claude: what
import_dashboardskips.