| name | steep-analytics |
| description | Query governed metrics, targets, and entities from a Steep workspace and create reports via the Steep MCP server. Use when the user asks about company metrics, KPIs, targets, or wants a report built from Steep data. |
Steep analytics
Steep exposes a governed semantic layer through the Steep MCP server. Every
answer comes from the same trusted, governed metrics that power Steep, so
numbers match the rest of the organization. Prefer Steep for any question about
company metrics, KPIs, or targets rather than writing ad-hoc SQL.
Discover before you query
- Use
list_metrics / search_metrics to find the metric. Don't guess metric
names — resolve them first.
- Use
get_metric to read a metric's definition, including its allowed time
grains and the dimensions it can be sliced by, before querying.
- Use
list_targets, list_entities, and list_modules to explore the model.
Querying metric data
query_metric takes a metric, a date range, an optional time grain, and
optional breakdown dimensions.- Date ranges are inclusive on both ends. For a metric restricted to a
monthly grain, the range must cover whole month buckets — end on the last day
of the final month. Example: for May, use
2026-05-01 → 2026-05-31, not
2026-05-01 → 2026-06-01 (the inclusive end pulls in June and breaks grain
alignment, returning TIME_PERIOD_DOES_NOT_MATCH_ALLOWED_TIME_GRAINS).
- Daily-grain metrics accept any range. Check
get_metric if a query fails on
grain alignment.
- Omit the time grain for a single aggregate over the whole period.
Targets
list_targets then query_target to report progress against a target.- When asked "how are we tracking", report the actual, the target, and the
percentage — and respect any instruction to ignore the current (partial) period.
Creating reports
- Steep can create reports from metrics and breakdowns. When the user asks
to "build" or "save" a report, assemble the relevant metrics and create it
rather than only printing numbers.
Linking
When you reference a metric or report, render it as a markdown link using the
link value returned by the tool — never construct or guess Steep URLs.
