MCP Reference
MCP uses Streamable HTTP at:
POST /mcpLegacy HTTP+SSE transport is not part of the public portal surface.
MCP keeps the stable POST /mcp transport and advertises the tool names for this latest contract during discovery.
Preferred Tools
| Tool | Use when |
|---|---|
compile_analytics_question | Generate a validated structured analytics query without execution. |
run_analytics_question | Compile, validate, enqueue, poll, and fetch a result from a natural-language question. |
run_structured_analytics_query | Validate and run a non-empty structured analytics query from the compiler or a trusted user payload. |
list_available_clients | List active client IDs and names available to the caller token. |
get_client_data_freshness | Check the latest regular DBT attribution update and vendor pull before interpreting today or yesterday. |
search_analytics_catalog | Discover metrics, dimensions, clients, and optional indexed dimension values. |
search_dimension_values | Find exact campaign, ad set, product, channel, or other indexed values. |
explain_analytics_query | Explain query planning metadata from validation or result payloads. |
open_analytics_catalog_picker | Open the optional picker UI when MCP Apps are enabled upstream. |
Call get_client_data_freshness before answering analytics
questions that cover today (the current day) or yesterday, and whenever data
lag could change the interpretation. The tool is read-only, requires one
token-authorized client_id, and excludes backfills.
Response Detail
MCP compile and run tools return compact JSON by default. Pass:
{ "response_detail": "full" }only when debugging compiler ranking, validation normalization, async URLs, or other low-level diagnostics.
OAuth Discovery
When OAuth is enabled, the MCP service publishes protected-resource metadata at:
/.well-known/oauth-protected-resource
/.well-known/oauth-protected-resource/mcpThe metadata advertises authorization servers, supported scopes, and bearer-header usage.
Value Search Warning
Dimension-value hits are discovery evidence. They do not automatically add filters to compile or run calls. Pass exact dimensions and filters intentionally.