Vantage

Create a new Recommendation View in Vantage. Recommendation Views are saved filters for recommendations. They can be scoped by provider, billing account, cloud account, region, recommendation type, tags, creation date, and minimum potential savings. Use get-myself to find available workspaces. Use list-recommendations to discover valid provider IDs, recommendation types, accounts, regions, tags, and savings ranges before creating a view. Filter examples: - AWS recommendations in production: provider_ids ["aws"], tag_key "environment", tag_value "production" - High-savings recommendations: min_savings 100 - Recommendations created in a date range: start_date "2024-01-01", end_date "2024-06-30"

create-recommendation-view

Create a scenario-model ReportForecast for a Cost Report. Provide at least one of scenario_model_tokens or business_metric_token. Use list-scenario-models and list-business-metrics to discover tokens. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot update the Cost Report.

create-report-forecast

Create a new Report Notification in Vantage. Report Notifications send scheduled Cost Report summaries to configured users, Slack channels, or Microsoft Teams channels on a daily, weekly, or monthly cadence. Use this tool when a user asks to create, add, or set up scheduled report delivery for an existing Cost Report. Do not use this for Cost Alerts, budget alerts, threshold alerts, or spend-limit notifications. Cost Alerts notify users when spend crosses a configured threshold; Report Notifications deliver scheduled report summaries.

create-report-notification

Create a saved Resource Report in Vantage. Resource Reports persist a VQL filter over cloud infrastructure resources so the view can be reopened, shared, added to dashboards, and queried later with list-provider-resources via resource_report_token. Returns the report token; link users to https://console.vantage.sh/go/<token>. Resource Report VQL uses the resources and tags namespaces — not Cost Report costs VQL (create-cost-report). Use list-provider-resources for one-off resource queries without saving a report; use list-resource-reports to browse existing reports.

create-resource-report

Create a ScenarioModel with optional periods and provider/service filters. Assign created ScenarioModels to Cost Report forecasts with create-report-forecast or update-report-forecast. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot create models.

create-scenario-model

Creates a new Virtual Tag (Virtual Tag Config) in Vantage. Do not use this to edit an existing Virtual Tag Config; use update-virtual-tag-config for config settings or value order, and the Virtual Tag Config Value tools for individual values. Virtual Tag Configs define a derived (virtual) tag key and a set of values determined by VQL filters. This is useful for normalizing cost attribution (e.g., mapping multiple provider tag formats into a single tag), collapsing noisy tag keys, and optionally overriding provider-supplied tags. You can optionally: - backfill_until: backfill the virtual tag values to an earliest month - collapsed_tag_keys: collapse values for specific underlying tag keys (optionally scoped by provider) - values: define named values via VQL filters, optionally linked to Business Metrics and/or cost metrics

create-virtual-tag-config

Adds a new mapping/value to an existing Virtual Tag Config without replacing its other values. Use this to append a mapping while editing a Virtual Tag; new values are added after existing values.

create-virtual-tag-config-value

Create a new Workspace in Vantage. Workspaces are isolated environments for organizing cost data and access control across teams.

create-workspace

Delete an Annotation by its token. This action is irreversible. Use list-annotations to find the annotation_token.

delete-annotation

Deletes a Billing Rule by its token. This action is irreversible.

delete-billing-rule

Deletes a Budget by its token. This action is irreversible.

delete-budget

Deletes a Canvas by its token. This action is irreversible.

delete-canvas

Deletes a Cost Alert by its token. This action is irreversible.

delete-cost-alert

Deletes a cost report by its token. This action is irreversible.

delete-cost-report

Deletes a Dashboard by its token. This action is irreversible.

delete-dashboard

Deletes a financial commitment report by its token. This action is irreversible.

delete-financial-commitment-report

Deletes a Folder. Cost Reports within the Folder will not be deleted.

delete-folder

Deletes a Network Flow Report by token.

delete-network-flow-report

Deletes a recommendation view by its token. This action is irreversible.

delete-recommendation-view

Delete a scenario-model ReportForecast by token. This action is irreversible. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot update the Cost Report.

delete-report-forecast

Deletes a Report Notification by its token. This action is irreversible and stops the scheduled Cost Report summary from being delivered. Use this tool when a user asks to delete, remove, disable, or stop a scheduled report notification. Do not use this for deleting Cost Alerts, budget alerts, threshold alerts, or spend-limit notifications.

delete-report-notification

Deletes a resource report by its token. This action is irreversible.

delete-resource-report

Delete a ScenarioModel by token. This action is irreversible and regenerates forecasts that referenced the model. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot delete the model.

delete-scenario-model

Deletes an entire Virtual Tag Config and all of its mappings/values. To remove only one mapping, use delete-virtual-tag-config-value instead.

delete-virtual-tag-config

Deletes exactly one mapping/value from an existing Virtual Tag Config, not the containing tag. Remaining values are preserved without replacement or reordering.

delete-virtual-tag-config-value

Gets a specific anomaly alert by its token.

get-anomaly

Gets a specific Billing Rule by its token. Returns details about the rule including its type, configuration, and applicable dates.

get-billing-rule

Gets a specific Budget by its token. Optionally includes performance data showing actual spend vs. budget amounts by period. The token of a budget can be used to link the user to the budget in the Vantage Web UI. Build the link like this: https://console.vantage.sh/go/<BudgetToken>

get-budget

Get a specific BusinessMetric by token. BusinessMetrics can be attached to Cost Reports for per-unit cost analysis, and their values can be retrieved with get-business-metric-values or get-business-metric-forecasted-values.

get-business-metric

Get forecasted values for a BusinessMetric. Values are returned in descending date order by the Vantage API and can include optional labels. Use start_date to limit results to values on or after a YYYY-MM-DD date. This endpoint is paginated. If the user asks for all values, complete data, or values for a date range such as a month, keep calling this tool with pagination.nextPage until pagination.hasNextPage is false before answering. The API only supports a start_date lower bound. For bounded ranges, such as a specific month, fetch all pages from the requested start date and then filter the returned values to the requested end date locally.

get-business-metric-forecasted-values

Get historical values for a BusinessMetric. Values default to monthly sums grouped by label. Use day for daily sums or raw to preserve original timestamps, including hourly values; binned sums may not suit gauges or percentages. Values are returned in descending date order by the Vantage API and can include optional labels. When a request depends on labels but exact values are not confirmed, call list-business-metric-labels first and pass the selected values through label_values. Skip label discovery when exact values are already supplied. Use start_date to limit results to values on or after a YYYY-MM-DD date. This endpoint is paginated. If the user asks for all values, complete data, or values for a date range such as a month, keep calling this tool with pagination.nextPage until pagination.hasNextPage is false before answering. The API only supports a start_date lower bound. For bounded ranges, such as a specific month, fetch all pages from the requested start date and then filter the returned values to the requested end date locally.

get-business-metric-values

Gets a specific Canvas by its token. Returns the canvas details including its title, prompt, status, and structured table data. The token of a canvas can be used to link the user to the canvas in the Vantage Web UI. Build the link like this: https://console.vantage.sh/go/<CanvasToken>

get-canvas

Gets a specific Cost Alert by its token. Use this tool when you already have a cost alert token, such as one returned by list-cost-alerts or referenced in Vantage. Cost Alerts are threshold-based spending alerts for Cost Reports. Do not use this for Report Notifications, scheduled report summaries, or recurring Cost Report delivery.

get-cost-alert

Gets a specific Cost Alert event by its token. Use after list-cost-alert-events when you need the full trigger record.

get-cost-alert-event

Get the list of Cost Provider Accounts that the current user has access to in their workspace and their names. This is useful for mapping IDs you have gotten from other endpoints to human-readable names, or if you need to get the ID of a Cost Provider Account to use in places. The account_id in this result can be passed as the account_id in VQL queries. When possible, use the provider or account_id filters to narrow results. Results are paginated for large accounts.

get-cost-provider-accounts

Gets a specific cost report by its token. The token of a report can be used to generate a link to the report in the Vantage Web UI: https://console.vantage.sh/go/<token> The same token can be used with the get-cost-report-forecast tool to retrieve forecasted future costs for the report.

get-cost-report

Given a Cost Report Token, Vantage can forecast the costs for a given time range. Vantage will return costs that are *predicted*, but have not yet been actually incurred. If the user does not set a date, best to pick the next month as the default. The report token can be used to link the user to the report in the Vantage Web UI. Build the link like this: https://console.vantage.sh/go/<CostReportToken>

get-cost-report-forecast

Get data that is available to the current auth token. This includes the list of Workspaces they have access to. default_workspace_token: The token of the workspace that is set as the default for the user and can be used for queries unless told otherwise.

get-myself

Gets a specific dashboard by its token. The token of a dashboard can be used to generate a link to the dashboard in the Vantage Web UI: https://console.vantage.sh/go/<token>

get-dashboard

Gets a specific financial commitment report by its token. Use this tool when you already have a financial commitment report token, such as one returned by Vantage or referenced in the Vantage console. The response includes the report's title, workspace, date range, grouping, cost scope, and filter configuration.

get-financial-commitment-report