Skip to main content
This page covers the tools the Kubit MCP server exposes, their inputs, the report types 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 except init 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

InputToolValues
kindcreate_report, get_report_instructionsquery, dataTable, funnel, path, activity, grid, agentFlow, retention, inspection or significance. get_report_instructions also takes cohort. Report types explains each.
definitioncreate_reportThe report as JSON, following the schema get_report_instructions returns for its kind
cohortscreate_reportCohorts that only this report uses, each under a key the assistant chooses. The result gives each cohort’s ID for later reports.
basedOnReportIdcreate_reportThe 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.
rowsget_reportReads a page of the report’s rows instead of its summary: offset (default 0) and limit (default 50, at most 100)
where, columnsget_reportwhere 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.
kindpublish_componentFILTER, MEASURE, VIRTUAL_EVENT, BINNING or COHORT
selectorpublish_componentWhich 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
namepublish_componentA 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.
pipelineTypeworkspace_createAGENT (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, targetmemoryread returns both stores. update changes one store, named in target as workspace or user. init and switch already return both stores.
operationsmemory1 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.
requestTypehelpBUG, FEEDBACK or QUESTION. isUrgent applies to BUG only.
tilesimport_dashboard1 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 with get_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.
BehaviorDetails
Where the token comes frominit, switch or workspace_create
Changing workspaceswitch returns a new token. Use it on every later call.
ExpiryThe token doesn’t expire
Lost accessKubit 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 tokenInvalid 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

ConstraintValue
Reports returned by a get_report search or recent list10
Sample rows in a create_report result20
Rows in one get_report page50 by default, at most 100
Reuse of an identical create_report definitionData computed in the last 6 hours
get_report refresh wait50 seconds
help wait for a support replyAbout 20 seconds. After that, the reply goes to your email.
import_dashboard tiles1 to 20
import_dashboard dashboard name50 characters
import_dashboard tile title80 characters
publish_component description2,048 characters
workspace_mint_key note1 to 255 characters
Lumos memory entry300 characters
memory changes per call1 to 10
workspace_mint_key on an example workspaceNot supported
Deleting a published componentNot supported through the MCP server. A published component is visible to everyone in the workspace.