Skip to main content
The Data MCP endpoint gives an authenticated assistant read access to saved queries, analysis views, and recent runs visible to its service account. It does not create queries, execute new runs, or return run result rows through these tools.

​
Connect with a scoped key

Use POST /api/v2/metrics/mcp with a service-account API key carrying metrics:read. The same workspace and connection permissions used by the Data API apply. Keep the key in the assistant application’s secure connection settings. Send JSON-RPC 2.0 requests for initialize, tools/list, or tools/call. Discover the available tool schemas with tools/list before constructing a call.

​
Choose a read operation

List operations return a bounded set of records. The query and run get tools search the visible recent collection; use the REST API for paginated workflows and operation results.

​
Keep discovery separate from execution

Use these tools to understand existing definitions and results before taking an action elsewhere. To create a query or execute an operation, implement the corresponding Data API command with its required scope and idempotency key. See operations and webhooks for completion handling.