Obtain your Semantic Layer GraphQL endpoint URL, which follows the pattern https://semantic-layer.YOUR_HOST.getdbt.com/api/graphql for single-tenant deployments
Authenticate by including a service token or personal access token in the Authorization header as Bearer YOUR_TOKEN
Send a POST request with a GraphQL query body calling queryRecords, specifying filters such as date range, status, and metric names to narrow the history
Parse the returned fields including query status, timing, SQL dialect, and the metrics and group-by dimensions used in each historical query
Use the paginated metadata query endpoints (available as of 2025) to handle large manifests without hitting response size limits
Known gotchas
The queryRecords endpoint returns history for both Insights queries and Semantic Layer API queries; filter by source type if you need only programmatic API calls in the results
Personal access tokens (PATs) are supported for user-level authentication in the GraphQL API as of 2025, which avoids the need to share service tokens across team members
The GraphQL schema explorer URL differs from the query endpoint; use the schema explorer only to introspect available fields and operations, not to execute production queries
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp