Vantage MCP

Add a user to a Team by email address and assign their Team role.

Create an Annotation on one or more Cost Reports for a specific date. Use this tool when a user asks to add a note, explanation, or event marker to Cost Reports.

Creates a new Billing Rule. Billing rules allow you to adjust, exclude, credit, charge, or apply custom modifications to your cost data. The required fields depend on the rule type: - Exclusion rules require charge_type. - Adjustment rules require percentage. Optionally accepts service and category to scope the adjustment. - Charge and Credit rules require service, category, sub_category, amount, and start_date. - Custom rules require sql_query.

Creates a budget based on the parameters specified. This is useful if you have been tasked with managing budgets or you are building a cost report with budgets in mind.

Create a Budget Alert that notifies users or connected channels when one or more Budgets reach a percentage threshold during a monthly time window.

Creates a Canvas based on the parameters specified. A Canvas is an AI-generated cost analysis view created from a natural language prompt. The prompt describes what cost data to analyze (e.g. "Show me monthly costs by provider"). Creating a canvas triggers an asynchronous refresh to generate the data.

Create a new Cost Alert in Vantage. Cost Alerts are threshold-based spending alerts for one or more Cost Reports. Use this tool when a user asks to create, add, or set up a cost alert, spending alert, budget alert, threshold alert, or spend-limit notification. Do not use this for Report Notifications, scheduled report summaries, or recurring Cost Report delivery.

Create a new Cost Report in Vantage. Cost Reports are saved queries that can be used to track and analyze spending over time. They can be filtered using VQL (Vantage Query Language) and configured with various display options. VQL Filtering Guide: All costs originate from a Cost Provider (generally a cloud company like AWS, Azure, Datadog) and then filter on a service that they provide (like EC2, S3, etc). A cost provider is required on every VQL query. VQL is always in parenthesis. Always use single quotes around names that are being queried. Basic VQL Syntax: - Query on a cost provider: (costs.provider = '<provider name>') - Query on a service: (costs.provider = '<provider name>' AND costs.service = '<service name>') - Multiple providers: ((costs.provider = 'aws') OR (costs.provider = 'azure')) - Multiple services: (costs.provider = 'aws' AND costs.service IN ('AWSQueueService', 'AWSLambda')) - Filter by region: (costs.provider = 'aws' AND costs.region = 'us-east-1') - Filter by account: (costs.provider = 'aws' AND costs.account_id = '1000000717') Tag Filtering: - Tag with specific value: (costs.provider = 'aws' AND tags.name = 'environment' AND tags.value = 'production') - Any value of a tag: (costs.provider = 'aws' AND tags.name = 'environment') - Resources without a tag: (costs.provider = 'aws' AND tags.name = NULL) - Multiple tag values: (costs.provider = 'aws' AND tags.name = 'environment' AND (tags.value = 'dev' OR tags.value = 'staging')) Use get-myself to find available workspaces and list-cost-providers/list-cost-services to find valid provider and service names for your VQL queries.

Create a new Dashboard in Vantage. Dashboards are collections of widgets that visualize cost data. You can optionally attach widgets (by their widgetable_token) and saved filters, and you can control the time range using either: - date_interval (recommended), or - start_date + end_date (custom range) Note: start_date/end_date are incompatible with date_interval. The list of supported widgets is: - cost reports - usage reports - resource reports - kubernetes efficiency reports - financial commitment reports - recommendation saved views The token returned in the response can be used to link to the Dashboard in the Vantage Web UI: https://console.vantage.sh/go/<token>

Create a new Financial Commitment Report in Vantage. Financial Commitment Reports track committed spend and on-demand costs over time. They can be filtered using VQL and grouped by dimensions such as commitment type, service, region, or tags. VQL Filtering Guide: Financial Commitment Report VQL uses the financial_commitments namespace. A provider filter should be included in each query, and string values should be wrapped in single quotes. Basic VQL Syntax: - Query on a provider: (financial_commitments.provider = 'aws') - Query on a service: (financial_commitments.provider = 'aws' AND financial_commitments.service = 'AmazonEC2') - Multiple services: (financial_commitments.provider = 'aws' AND financial_commitments.service IN ('AmazonEC2','AmazonRDS')) - Filter by billing account: (financial_commitments.provider = 'aws' AND financial_commitments.provider_account_id = '123456789012') - Filter by region: (financial_commitments.provider = 'aws' AND financial_commitments.region = 'us-east-1') - Filter by tag: (financial_commitments.provider = 'aws' AND financial_commitments.resource_tags->>'environment' = 'production') Use get-myself to find available workspaces. Use the VQL for Financial Commitment Reports resource for the full list of available financial_commitments fields and examples.

Create a folder for organizing Cost Reports or Resource Reports. Set type to CostFolder for Cost Reports or ProviderResourceFolder for Resource Reports.

Creates a saved Network Flow Report for analyzing cloud network traffic by cost or bytes.

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 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 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 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 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 a Team and optionally associate it with Workspaces, users, and a default Dashboard.

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

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 a new Workspace in Vantage. Workspaces are isolated environments for organizing cost data and access control across teams.

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

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

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

Delete a Budget Alert by token. This permanently removes the alert without deleting its monitored Budgets.

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

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

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

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

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

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

Deletes a Network Flow Report by token.

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

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.

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.

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

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 a Team.

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

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

Gets a specific anomaly alert by its token.

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

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 a specific Budget Alert by token. Budget Alerts monitor Budget objects.

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 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 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.

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>

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.

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

Get Cost Provider Accounts in a workspace with human-readable titles. Useful for mapping account IDs to names, or looking up an account_id for VQL.

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.

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>

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>

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. Use query-financial-commitment-report-costs with the same token to retrieve cost data for the report.

Gets a specific Folder by its token.

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.

Gets a saved Network Flow Report by token. Open in the console at https://console.vantage.sh/go/<token>.

Get detailed information about a specific provider resource using its token or UUID. This returns comprehensive details about the resource including: - Resource metadata (instance type, size, configuration, etc.) - Account and billing account information - Provider and region details - Creation timestamp - Optional cost breakdown by category The resource_token can be either a Vantage token (starting with prvdr_rsrc) or the resource's UUID/ARN from the cloud provider. Set include_cost to true to get cost information broken down by category.

Get comprehensive details about a specific cost optimization recommendation using its unique token. This tool provides in-depth information about a single recommendation including: - Full description of the optimization opportunity - Exact potential cost savings amount and currency - Current status (open, resolved, dismissed) - Category and type of recommendation (e.g., ec2_rightsizing_recommender, unused_financial_commitments) - Cloud provider and provider account information - Service being optimized (e.g., EC2, RDS, S3) - Number of resources that would be affected - Creation and last updated timestamps - Additional metadata specific to the recommendation type Use this tool after getting a recommendation token from list-recommendations to understand exactly what optimization is being suggested and the potential impact. The recommendation token can also be used with get-recommendation-resources to see the specific infrastructure resources involved.