MCP-Server
Plutus
com.plutus-cloud/plutus-cost-data
Was dieses MCP kann
Analyzes cloud, AI, and SaaS costs with spend queries, budgets, anomalies, usage metrics, savings recommendations, dashboards, and business-event correlation.
Funktionen
Tools
31
Tools
explain_cost_change
Explain a specific cost change: which timeline events line up with it, how strongly, and how much of the move Plutus could account for. Ask this about any point on a cost chart â it is not limited to anomalies the detector flagged (use list_anomalies for those; each already carries the same explanation).
RENDER `explanation.sentences` AS WRITTEN. They are generated under a strict discipline and are the only phrasing this data supports: Plutus reports temporal and dimensional evidence, never causation. Each candidate carries a `claim` of "coincides" (temporal proximity only â the common case), "consistent_with" (proximity plus a confirmed link between that event source and this cost entity) or "accounts_for" (a known dollar amount that matches the move). Do not upgrade one to another, do not say an event "caused" or "led to" the change, and do not merge several candidates into a single narrative.
Three separate numbers, never interchangeable: `change_evidence` is how sure we are a real change-point exists at all; `attribution_completeness` is what fraction of the move was localized to a specific part of the bill (a low value means "we do not know what this spend is yet", which is NOT the same as "nothing explains it"); `p_cause` is per candidate, and sums with `p_unknown` to 1. `tier: "unknown"` means we looked and found nothing that lines up â say that, rather than reaching for the top-ranked candidate anyway. Confidence is capped at 0.60 by design; there is no "high" tier today.
Body: `dimension` + `value` name the slice (e.g. service=AmazonEC2), optional `cost_source_id` narrows it, and exactly one of `day` or `range` says when. A range is narrowed to the single biggest-moving day inside it, reported as `explained_day`. Mirrors POST /api/accounts/:accountId/cost-changes/explain.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dimension', 'value'], 'properties': {'day': {'type': 'string', 'description': 'YYYY-MM-DD â\x80\x94 the day to explain'}, 'range': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}, 'description': 'Half-open YYYY-MM-DD range; narrowed to its biggest-moving day'}, 'value': {'type': 'string', 'description': 'The dimension value that moved, e.g. "AmazonEC2"'}, 'dimension': {'enum': ['service', 'region', 'linked_account', 'usage_type', 'resource_id'], 'type': 'string', 'description': 'Which dimension names the slice'}, 'cost_source_id': {'type': 'string', 'description': 'Narrow to one cost source, e.g. "aws"'}}}
get_cost_entries
Fetch raw per-service cost entries for this account over a date range (unaggregated). Prefer query_costs for time-bucketed/aggregated spend â this is for inspecting individual rows. Each row's `cost` is in USD (see the response's top-level `currency` field), like every other figure this server returns. A row also carries `native_cost`/`native_currency` â what the provider actually billed, for reconciling against their invoice. Those are the one exception to the USD rule here: never sum or compare `native_cost` across rows, and never quote it without naming the row's `native_currency`. Unlike query_costs, there is no cost_metric parameter here â `cost` is always billed cost, never amortized.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}}}
get_dashboard
Fetch one org-shared dashboard's full layout â its placed widgets, custom metrics and custom charts, and their grid positions. A `widgets` entry references a preset catalog_id (see list_dashboard_widget_catalog); `customMetrics`/`customCharts` carry their own full config inline. Call this before set_dashboard_widgets if you want to keep some of what's already there rather than replacing the whole set â that tool always replaces everything.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dashboard_id'], 'properties': {'dashboard_id': {'type': 'string', 'description': 'A shared dashboard id from list_dashboards'}}}
list_alert_channels
List this account's alert notification channels (Slack/Teams/webhook/email) â need a channel's id to call create_alert_subscription. Never returns the channel's credentials/URL, only its id/type/name/enabled state.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_alert_deliveries
List recent alert delivery history for this account (did an alert actually fire, and did it send successfully) â the same data behind the Alerts page's delivery heatmap. Does not include the delivery error text. Mirrors GET /api/accounts/:accountId/alert-deliveries.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'description': 'Max rows, most recent first (default: 100)', 'exclusiveMinimum': 0}}}
list_alert_subscriptions
List which alert channels are subscribed to which trigger (a specific budget's spend_threshold, or account-wide event_overage/cost_anomaly). Mirrors GET /api/accounts/:accountId/alert-subscriptions.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_anomalies
List detected cost anomalies for this account over a trailing lookback window â the real output of Plutus's nightly anomaly detector (severity, baseline vs. current spend, and what drove a tag-level spike), not something recomputed here from raw spend. Prefer this over eyeballing query_costs for "did anything spike" â the detector already accounts for day-of-week baselines and an absolute-dollar noise floor that a naive comparison would miss or over-trigger on.
Capped at 200 rows, most recent first; `days` (default 30, max 90) bounds the lookback. `kind` is "service" or "tag". `current_cents`/`baseline_cents`/`delta_cents` are the USD base. `suppressed: true` means a human has marked this exact signature (provider+service, or tag_key+tag_value) as expected â mention it but do not lead with it as a live problem. `driven_by` is null when driver attribution was not measured for this anomaly and `[]` when it WAS measured and found no dominant driver â those mean different things. Its entries differ by anomaly kind: a tag anomaly's entries are service-shaped (`service`/`cost_source_id`/`share_pct` â the services that fed the tag_value's spike); a service anomaly's entries, when the account has resource-grain detection enabled, are resource-shaped (`resource_id`/`resource_type`/`share_pct` â the specific resources, e.g. an EC2 instance or Lambda function, that drove that service's spike). Report a resource entry as a decomposition of the same service anomaly, never as a separate anomaly of its own. `correlated_events` is the service-anomaly counterpart: deploy/incident/release activity that was unusual (above the account's own baseline rate) in the 2-day window ending on the spike day, ranked by share of that excess. Same null-vs-`[]` distinction â null is "not measured" (a tag anomaly, or a row recorded before this shipped), `[]` is "measured and nothing was unusual". It is account-scoped and temporal: it does NOT claim the event caused this particular service's spend to rise, so report it as activity that lines up, never as a cause. `notified: false` means this anomaly was recorded but withheld from alerting because its tag_key was already at the per-run notify cap. Mirrors GET /api/accounts/:accountId/anomalies.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'days': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Trailing lookback window in days (default: 30)'}}}
list_anomaly_suppressions
List this account's active anomaly suppressions â signatures (a provider+service pair, or a tag_key+tag_value) a human has marked as expected, so the detector stops surfacing them. Each has an `expires_at` (null = indefinite). Mirrors GET /api/accounts/:accountId/anomaly-suppressions. Creating/deleting a suppression is not available over MCP.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_budgets
List this account's spend budgets with their current-cycle status (spend so far, projected total, ok/warning/exceeded state, and forecast state). Mirrors GET /api/accounts/:accountId/budgets. A budget carries its own `currency` (budgets are NOT converted to the USD base the cost tools return), and `amount_cents` is denominated in it; `spend_cents`/`projected_cents` are in `status_currency`, the budget's currency as of the rollup that wrote them. Never quote any of these figures as dollars without checking those two fields.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_commitment_expirations
List this account's Reserved Instance / Savings Plan / Azure Reservation commitments with their expiration dates, ordered soonest-first. `days_until_expiration` is computed server-side against the current UTC date (negative means already expired â rows are not pruned immediately on expiry, so check the sign). `latest_utilization_percentage` is the commitment TYPE's most recent monthly aggregate utilization (from list_commitment_utilization) applied to every active commitment of that type â there is no true per-commitment utilization API, so this is the closest real signal for "is this expiring commitment even being used," not an exact per-commitment figure. The same 30/14/7/1-day thresholds and 80% cutoff the automatic expiration alert uses are the right ones to flag here too, for consistency with what a subscribed channel already receives.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_commitment_utilization
List Reservation (RI) and Savings Plan utilization/coverage snapshots for this account â sourced from AWS Cost Explorer's own GetReservationUtilization/GetSavingsPlansUtilization APIs, one snapshot per commitment type per month. Shows how much of a purchased commitment is actually being used and its net savings vs on-demand. Mirrors GET /api/accounts/:accountId/commitment-utilization.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_cost_sources
List the cost-source providers (AWS, GCP, Anthropic, etc.) enabled for this account. Each row's cost_basis says where that provider's money figures come from: "invoiced" = amounts the provider actually charged; "estimated_from_provider_rates" = an estimate built from the provider's own published rates, because it exposes no historical billing API; "estimated_from_static_rates" = an estimate built from a list-rate card Plutus maintains, which will not reflect rates the customer negotiated. Qualify any total that includes an estimated source rather than reporting it as billed spend.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_cost_source_tag_keys
List distinct provider-native tag/label keys actually present in this account's cost data (AWS Cost Allocation Tags, GCP/Hetzner labels, Azure tags) â useful for discovering what a "tags.<key>" cost-tag-rule match could reference before creating one. Only ever populated on grain='service' rows. Omit cost_source_id to search across every enabled provider.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cost_source_id': {'type': 'string', 'description': 'Restrict to one provider, e.g. "gcp"'}}}
list_cost_source_tag_values
List distinct values seen for one provider-native tag/label key (see list_cost_source_tag_keys) in this account's cost data.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['tag_name'], 'properties': {'tag_name': {'type': 'string', 'description': 'A tag key returned by list_cost_source_tag_keys, e.g. "team"'}, 'cost_source_id': {'type': 'string', 'description': 'Restrict to one provider, e.g. "gcp"'}}}
list_cost_tag_rules
List the actual match rules for one of this account's cost-allocation tag_keys (see list_cost_tags) â which dimension values (or provider-native tag) map to which tag_value, and in what priority order. Rules are evaluated in ascending priority and the first match wins; spend matching no rule falls to "Untagged". Mirrors GET /api/accounts/:accountId/cost-tags/:tagKey/rules. IMPORTANT â a rule is NOT always a single assignment: when its `splits` field is non-null it is an array of {tag_value, weight} with weights summing to 1, and matched spend is divided across those tag_values by weight rather than going wholly to the rule's own tag_value. On a split rule, `tag_value` is only the rule's display label (e.g. "Shared EKS cluster") and no spend is attributed to it. Do not describe a rule with splits as assigning its spend to one team. Note also that some spend may be reallocated after these rules run â see list_cost_tags' redistribute_bucket.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['tag_key'], 'properties': {'tag_key': {'type': 'string', 'description': 'One of the tag_keys returned by list_cost_tags'}}}
list_cost_tags
List the virtual cost-allocation tag_keys defined for this account (e.g. "team", "product"), each with the cost_entries grain it's locked to and how many rules map dimension values to a tag_value. Use a tag_key with query_costs (breakdown_by: "tag") to see spend broken down by it. redistribute_bucket, when non-null, names a bucket (often "Untagged") whose spend is dissolved into the other tag_values in proportion to their own attributed spend in the same period â so that bucket will not appear in a query_costs breakdown for this tag_key, and the other values include a proportional share of it. It reappears only in periods where there was no other spend to redistribute against.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_dashboards
List this account's org-shared dashboards â visible to every account member. Does not include any member's PERSONAL dashboard: those live in one specific signed-in user's own browser session and have no id an account-level MCP key can address. Use a returned `id` with get_dashboard, set_dashboard_widgets or delete_dashboard.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_dashboard_widget_catalog
List the built-in ("preset") dashboard widgets available to place with create_dashboard/set_dashboard_widgets â small `kpi` stat tiles and larger `widget` data cards, each with the id (`catalog_id`) a {"kind": "preset", "catalog_id": "..."} widget spec references. There is no preset chart: to put a trend chart on a dashboard, build one inline with a {"kind": "custom_chart", ...} spec instead of a catalog_id â see create_dashboard's description for that shape.
The response also carries `grid_cols` (the canvas width every widget's x/w is measured against) and `size_bounds`, the min/max `w`/`h` each widget TYPE (`kpi`/`chart`/`widget` â not each individual catalog_id) accepts when a spec overrides its default size â use these before calling create_dashboard/set_dashboard_widgets with an explicit `w`/`h`.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_data_health
List sync health for every cost/event/usage connection this account has â last synced time, next scheduled sync, the outcome of its most recent run, and `is_overdue` (no successful sync within twice the connection's own effective sync interval). `status` is only ever set on a successful sync and is never flipped back on failure, so `is_overdue` â not `status` â is the real signal that a connection has gone stale. Check this before asserting that recent cost or usage data is complete, especially right before calling query_costs or query_usage for a very recent date range. Mirrors GET /api/accounts/:accountId/data-health.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_dimensions
List the distinct values seen for a given dimension (service, region, linked_account, usage_type, or operation) for one provider â useful for discovering filter values before calling query_costs.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cost_source_id', 'dimension'], 'properties': {'end_date': {'type': 'string'}, 'dimension': {'enum': ['service', 'region', 'linked_account', 'usage_type', 'operation', 'identity', 'namespace', 'workload', 'cluster', 'resource_id'], 'type': 'string'}, 'start_date': {'type': 'string'}, 'cost_source_id': {'type': 'string', 'description': 'Provider id, e.g. "aws" â\x80\x94 must be enabled for this account'}}}
list_event_facets
List the distinct values seen for a faceted event metadata field over a date range â currently just "repo" (every GitHub repo with at least one event), the same facet the Event Explorer's repo picker uses. Useful for discovering query_events' meta_repo filter values before calling it. Mirrors GET /api/events/facets.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['attr'], 'properties': {'attr': {'enum': ['repo'], 'type': 'string'}, 'end_date': {'type': 'string'}, 'source_id': {'type': 'string'}, 'start_date': {'type': 'string'}}}
list_savings_recommendations
List active cost-reduction recommendations for this account â sourced from each provider's own already-computed engine (AWS Cost Explorer, Azure Advisor, GCP Recommender), not something Plutus computes itself. `type` is one of: `terminate` (an idle resource to shut down), `modify` (an overprovisioned one to downsize), `commitment_savings_plan` or `commitment_reservation` (a commitment worth *buying* â an AWS Savings Plan / Reserved Instance, Azure reservation or savings plan, or GCP committed use discount). Commitment rows have no `current_instance_type`/`recommended_instance_type` â they are a purchase, not an instance swap; their term, payment option, lookback window and hourly commitment are in `detail`. Only one term/payment/lookback variant per commitment is surfaced (AWS: 30-day lookback, 1-year, no upfront â Cost Explorer's own console default), so do not report these as the only commitment options available. Mirrors GET /api/accounts/:accountId/savings-recommendations. Each recommendation carries the provider's own figure in its own `currency`; the total is in USD (stated in the response's `currency` field), since providers may bill in different ones.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_scheduled_reports
List this account's scheduled cost digests â cadence, scope (whole account, one cost source, or one cost-allocation tag value), destination alert channel, and when the next one is due. `next_period_label` names the concrete date range the next digest will cover. Mirrors GET /api/accounts/:accountId/scheduled-reports. Creating/editing a scheduled report is not available over MCP.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_tag_recommendations
List suggested cost-allocation tag rules this account doesn't have yet â high-spend values currently falling through to "Untagged" for an existing tag_key, or a provider-native tag worth promoting into a virtual tag_key of its own (see list_cost_tags). Each recommendation carries `estimated_monthly_spend_cents` (USD base) it would newly cover. Mirrors GET /api/accounts/:accountId/tag-recommendations. Accepting or dismissing a recommendation is a UI/REST-only action, not available over MCP.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_teams
List this account's teams (user groups) with their members and the cost-tag tag_value each is reserved under â team-scoped budgets (create_budget with scope_type: "team") reference a team's id as scope_ref. Mirrors GET /api/accounts/:accountId/teams.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_unit_metrics
List this account's saved unit-economics metrics â each one a cost ÷ business-unit ratio such as "cost per 1k API requests" or "infra cost per order". `numerator_scope` says which slice of spend is on top (the whole account, one cost source, or one cost-allocation tag_value â see list_cost_tags), `denominator_metric` names the usage metric counting the business units, and `denominator_scale` is the readability factor the ratio is quoted at (1, 1000 or 1000000). Pass an id to query_unit_costs to compute one over a date range.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_usage_dimensions
List the distinct values seen for a usage dimension ("metric" or "external_customer_id") over a date range â useful for discovering filter values before calling query_usage. Each entry pairs the raw `value` with a `label` (for external_customer_id, the customer's name from account_customers when known, falling back to the id itself). Mirrors GET /api/usage/dimensions.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dimension'], 'properties': {'end_date': {'type': 'string'}, 'dimension': {'enum': ['metric', 'external_customer_id'], 'type': 'string'}, 'start_date': {'type': 'string'}}}
query_costs
Query time-bucketed spend for this account, optionally broken down by a dimension (service, region, linked_account, usage_type, operation, or identity) or by a custom cost-allocation tag (see list_cost_tags), and filtered by dimension values. `identity` is per-actor spend (e.g. an OpenAI or Anthropic api_key_id) where a provider's cost/usage API can group by it; not every provider populates it. Mirrors the GET /api/analytics endpoint used by the Plutus dashboard charts. All amounts are in USD, converted from each provider's own billing currency at the rate in effect on the day of the charge; the response states this in its `currency` field.
A row carries `cost_basis` only when its `cost` figure is an estimate rather than a real invoiced charge â e.g. Anthropic's identity-grain rows, priced from Anthropic's own published per-token rates because Anthropic's cost API has no per-key breakdown at all. Absent (null) `cost_basis` means the figure is invoiced. Always qualify an estimated figure as such when relaying it â do not present it with the same confidence as an invoiced one.
Where a provider reports usage alongside cost, a row also carries `quantity` and its `unit` (e.g. tokens, GB-month), plus a derived `cost_per_unit` in that same USD base. Always read `cost_per_unit` together with `cost_per_unit_label`, which names the denominator it is quoted against: token costs are quoted per 1,000 tokens ("per 1k tokens", `cost_per_unit_scale: 1000`), NOT per single token. All four fields are null when the provider reports no usage, and also when the rows behind a group carry more than one unit â a total mixing tokens and GB-month is not a quantity, so none is given.
The response also carries `coverage.complete_through`: cost data for the newest periods often has not landed yet (it arrives hours-to-a-day after the period it covers), so `rows` may end before `end_date` without that being a gap in spend â the newest period(s) simply aren't complete yet. `coverage.lagging_sources`, when non-empty, names a cost source that is behind or has stopped reporting; recent periods will under-count its spend. Unlike query_unit_costs, `rows` is NOT truncated to the horizon here â treat complete_through as a caveat on the newest bucket(s), not evidence anything is missing from the rows themselves.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'tag_key': {'type': 'string', 'description': 'Required when breakdown_by is "tag" â\x80\x94 one of the tag_keys returned by list_cost_tags'}, 'end_date': {'type': 'string', 'description': 'ISO-8601 end of the date range (exclusive)'}, 'group_by': {'enum': ['day', 'week', 'month', 'quarter'], 'type': 'string', 'description': 'Time bucket size (default: day)'}, 'start_date': {'type': 'string', 'description': 'ISO-8601 start of the date range (inclusive)'}, 'cost_metric': {'enum': ['billed', 'amortized'], 'type': 'string', 'description': 'Which cost figure to sum (default: "billed"). "amortized" spreads prepaid commitments (AWS Reserved Instances/Savings Plans, Azure reservations) across the term they cover instead of showing the full charge on the day it was billed. Only AWS, FOCUS and Azure sources ever differ from billed â\x80\x94 every other provider writes amortized equal to billed, and that is the true figure for a SaaS subscription or LLM API, not a fallback. Amortized data only exists from 2026-08-04 onward and cannot be backfilled; rows before that date are billed-as-amortized regardless of which value is passed here. Not supported by get_cost_entries.'}, 'breakdown_by': {'enum': ['service', 'region', 'linked_account', 'usage_type', 'operation', 'identity', 'namespace', 'workload', 'cluster', 'resource_id', 'tag'], 'type': 'string', 'description': 'Dimension to break spend down by, or "tag" to break down by a virtual cost-allocation tag_key (see list_cost_tags) â\x80\x94 requires tag_key.'}, 'filter_region': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these region values'}, 'filter_cluster': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these cluster values'}, 'filter_service': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these service values'}, 'cost_source_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these provider ids (defaults to all enabled providers)'}, 'filter_identity': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these identity values'}, 'filter_workload': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these workload values'}, 'filter_namespace': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these namespace values'}, 'filter_operation': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these operation values'}, 'filter_usage_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these usage_type values'}, 'filter_resource_id': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these resource_id values'}, 'filter_linked_account': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these linked_account values'}, 'secondary_breakdown_by': {'enum': ['service', 'region', 'linked_account', 'usage_type', 'operation', 'identity', 'namespace', 'workload', 'cluster', 'resource_id'], 'type': 'string', 'description': 'A second dimension to break spend down by simultaneously with breakdown_by. Only pairs that some provider actually stores together on the same row are supported â\x80\x94 e.g. (service, region), (service, linked_account), (usage_type, operation), and Kubernetes\' (namespace, workload) â\x80\x94 any other pair returns an error. Not applicable when breakdown_by is "tag".'}}}
query_events
Query this account's business-event timeline (GitHub releases/PRs, PagerDuty incidents, Jira issues, GitLab, Salesforce onboarding/churn, Stripe subscription created/canceled, Vercel production deploys, Linear issue creation, Sentry newly reported errors) â the same events overlaid on the Cost/Event Explorer charts. Always scope with start_date/end_date: there is no pagination and results are capped at 5000 rows (oldest-first), so an unscoped query over a long history may be silently truncated. Carries no cost figure. Mirrors GET /api/events.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'description': 'Free-text, case-insensitive substring match against the event title'}, 'end_date': {'type': 'string', 'description': 'ISO-8601 end of the date range (inclusive)'}, 'meta_repo': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these GitHub repos (metadata.repo) â\x80\x94 only narrows events that carry a repo; events with no repo (e.g. Salesforce onboarding/churn) are unaffected regardless of value'}, 'source_id': {'type': 'string', 'description': 'Restrict to one event source, e.g. "github", "pagerduty", "jira"'}, 'event_type': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these event types, e.g. "issue_created", "deploy"'}, 'start_date': {'type': 'string', 'description': 'ISO-8601 start of the date range (inclusive)'}}}
query_unit_costs
Compute one of this account's saved unit-economics metrics (see list_unit_metrics) over a date range â the cost of a slice of spend divided by the business units it produced. Each row carries `cost` (the numerator, in the USD base like every other figure this server returns), `quantity` (the denominator, a raw count with no currency), and `unit_cost`.
CRITICAL: `unit_cost` is null whenever it could not be computed, and null does NOT mean zero. It means one half of the fraction is missing for that period â either no usage was ingested (a telemetry gap) or no cost data has landed yet. Do not describe a null unit cost as a cost of zero, and do not average nulls in as zeroes; the `coverage` block reports how many rows are affected and why. Always read `unit_cost` together with `denominator_label` (e.g. "per 1k requests"), which names what it is quoted against â a per-1k figure reported as a per-request figure is wrong by three orders of magnitude.
The series stops at `coverage.complete_through` rather than at the requested end_date whenever cost data for the newest periods has not arrived yet (it lands hours-to-a-day after the period it covers, while usage telemetry is pushed live). A short series is therefore normal and is NOT evidence that spend or usage stopped â say what it is complete through instead. `coverage.lagging_sources`, when non-empty, is the opposite case: a cost source that is behind or has stopped reporting, so recent periods are missing its spend and their unit costs read lower than the truth.
If `numerator_status.available` is false, the cost source this metric measured has been removed from the account and `rows` is empty. That is a broken definition, not a period of zero spend â never report it as costs having fallen.
Amounts are billed cost, never amortized, regardless of any cost_metric used elsewhere. A tag-scoped metric inherits that tag_key's allocation policy, so its numerator may include a redistributed share of shared spend (see list_cost_tags' redistribute_bucket) and will not match a raw dimension total.
A metric whose denominator_mode is "per_customer" returns one row per (period, customer) and a `customers` block splitting them into matched, cost_without_usage (spend attributed to a customer who is not sending telemetry) and usage_without_cost (telemetry from a customer whose spend is not being allocated). Those two lists are the honest caveat on any per-customer figure and are worth mentioning when either is non-empty.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['unit_metric_id'], 'properties': {'end_date': {'type': 'string', 'description': 'ISO-8601 end of the date range (exclusive)'}, 'group_by': {'enum': ['day', 'week', 'month', 'quarter'], 'type': 'string', 'description': 'Time bucket size (default: day)'}, 'start_date': {'type': 'string', 'description': 'ISO-8601 start of the date range (inclusive)'}, 'unit_metric_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'id of a metric returned by list_unit_metrics'}}}
query_usage
Query time-bucketed usage telemetry this account's own backend has pushed or synced in (e.g. API request counts, tokens processed) â the raw data unit-economics metrics divide cost by (see list_unit_metrics/query_unit_costs), inspected directly rather than through a pre-defined ratio. `quantity` is a raw count with no currency â never treat it as money. Optionally broken down by `external_customer_id` when the pushed rows carry one. Mirrors GET /api/usage.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'end_date': {'type': 'string', 'description': 'ISO-8601 end of the date range (exclusive)'}, 'group_by': {'enum': ['hour', 'day', 'week', 'month', 'quarter'], 'type': 'string', 'description': 'Time bucket size (default: day). "hour" is only supported for ranges of 7 days or less.'}, 'start_date': {'type': 'string', 'description': 'ISO-8601 start of the date range (inclusive)'}, 'breakdown_by': {'enum': ['external_customer_id'], 'type': 'string'}, 'filter_metric': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these metric names'}, 'filter_source_id': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to usage pushed/synced under these usage-source ids'}, 'filter_external_customer_id': {'type': 'array', 'items': {'type': 'string'}}}}
Verlauf
Letzte Tool-Änderungen
Geändert
get_cost_entries
1. October 2026 02:54
Geändert
list_dimensions
1. October 2026 02:54
Geändert
list_alert_deliveries
1. October 2026 02:54
Geändert
list_alert_subscriptions
1. October 2026 02:54
Geändert
list_alert_channels
1. October 2026 02:54
Geändert
list_budgets
1. October 2026 02:54
Geändert
list_teams
1. October 2026 02:54
Geändert
list_cost_source_tag_values
1. October 2026 02:54
Geändert
list_cost_source_tag_keys
1. October 2026 02:54
Geändert
list_cost_tag_rules
1. October 2026 02:54
Geändert
list_event_facets
1. October 2026 02:54
Geändert
query_events
1. October 2026 02:54
Geändert
list_usage_dimensions
1. October 2026 02:54
Geändert
query_usage
1. October 2026 02:54
Geändert
query_unit_costs
1. October 2026 02:54
Geändert
list_unit_metrics
1. October 2026 02:54
Geändert
get_dashboard
1. October 2026 02:54
Geändert
list_dashboards
1. October 2026 02:54
Geändert
list_dashboard_widget_catalog
1. October 2026 02:54
Geändert
list_scheduled_reports
1. October 2026 02:54
Geändert
list_data_health
1. October 2026 02:54
Geändert
list_tag_recommendations
1. October 2026 02:54
Geändert
list_anomaly_suppressions
1. October 2026 02:54
Geändert
explain_cost_change
1. October 2026 02:54
Geändert
list_anomalies
1. October 2026 02:54
Geändert
list_cost_tags
1. October 2026 02:54
Geändert
list_commitment_expirations
1. October 2026 02:54
Geändert
list_commitment_utilization
1. October 2026 02:54
Geändert
list_savings_recommendations
1. October 2026 02:54
Geändert
query_costs
1. October 2026 02:54
Entdecken
Ähnliche MCP-Server
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…