Tools

Admetrics exposes a small set of analytics tools that work the same way over MCP and REST. Each tool takes catalog-backed IDs and returns validated, warehouse-ready results. Use this page as the map; the API Reference documents every request and response field.

Catalog

• Search catalog — find exact metric, dimension, client, and indexed value IDs before building a query.
• List clients — enumerate the clients a token can access.

Explore the same data interactively in the Catalog Explorer.

Freshness

• Get client data freshness — return the most recent successful regular DBT attribution update and vendor pull for a client available to the caller token.

Agents should call get_client_data_freshness before answering analytics questions that cover today (the current day) or yesterday, and whenever data lag could affect interpretation. Backfills are excluded so repair activity does not make scheduled production data appear fresh.

Compile

• Compile question — turn a natural-language question into a structured analytics query without executing it.
• Explain query — return validation or result metadata for a structured query.

Run

• Run structured query — validate and run a structured AQL query, then fetch the result in the requested format.
• Run question — compile, validate, enqueue, poll, and fetch a natural-language question in one call.

Build and run structured queries interactively in the Query Builder.

Access

• API Access — create, list, report on, and revoke managed API keys for server-side integrations and local development.

Reference

• API Reference — REST endpoints, parameters, and return formats.
• MCP Reference — the advertised MCP tool names and transport contract.