- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 134
- Triggers: 0
- Slug:
VANTAGE_MCP - Version: 20261018_00
Tools
Add-team-member
Add-team-member
Create-annotation
Create-annotation
Create-billing-rule
Create-billing-rule
VANTAGE_MCP_CREATE_BILLING_RULECreates 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.
Input Parameters
Create-budget
Create-budget
VANTAGE_MCP_CREATE_BUDGETCreates 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.Input Parameters
Create-budget-alert
Create-budget-alert
VANTAGE_MCP_CREATE_BUDGET_ALERTCreate a Budget Alert that notifies users or connected channels when one or more Budgets reach a percentage threshold during a monthly time window.Input Parameters
Create-canvas
Create-canvas
VANTAGE_MCP_CREATE_CANVASCreates 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.Input Parameters
Create-cost-alert
Create-cost-alert
VANTAGE_MCP_CREATE_COST_ALERTCreate 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.Input Parameters
Create-cost-report
Create-cost-report
VANTAGE_MCP_CREATE_COST_REPORTCreate 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 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’))
Input Parameters
wrkspc_*). Ignored if folder_token is set. Required if the API token is associated with multiple Workspaces.Create-dashboard
Create-dashboard
VANTAGE_MCP_CREATE_DASHBOARDCreate 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)
- cost reports
- usage reports
- resource reports
- kubernetes efficiency reports
- financial commitment reports
- recommendation saved views
Input Parameters
Create-financial-commitment-report
Create-financial-commitment-report
VANTAGE_MCP_CREATE_FINANCIAL_COMMITMENT_REPORTCreate 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’)
Input Parameters
Create-folder
Create-folder
VANTAGE_MCP_CREATE_FOLDERCreate a folder for organizing Cost Reports or Resource Reports. Set type to CostFolder for Cost Reports or ProviderResourceFolder for Resource Reports.Input Parameters
wrkspc_*). Ignored if parent_folder_token is set. Required if the API token is associated with multiple Workspaces.Create-network-flow-report
Create-network-flow-report
Create-recommendation-view
Create-recommendation-view
VANTAGE_MCP_CREATE_RECOMMENDATION_VIEWCreate 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”
Input Parameters
Create-report-forecast
Create-report-forecast
VANTAGE_MCP_CREATE_REPORT_FORECASTCreate 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.Input Parameters
Create-report-notification
Create-report-notification
VANTAGE_MCP_CREATE_REPORT_NOTIFICATIONCreate 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.Input Parameters
Create-resource-report
Create-resource-report
VANTAGE_MCP_CREATE_RESOURCE_REPORTCreate 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.Input Parameters
Create-scenario-model
Create-scenario-model
VANTAGE_MCP_CREATE_SCENARIO_MODELCreate 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.Input Parameters
Create-team
Create-team
Create-virtual-tag-config
Create-virtual-tag-config
VANTAGE_MCP_CREATE_VIRTUAL_TAG_CONFIGCreates 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
Input Parameters
Create-virtual-tag-config-value
Create-virtual-tag-config-value
Create-workspace
Create-workspace
Delete-annotation
Delete-annotation
Delete-billing-rule
Delete-billing-rule
Delete-budget
Delete-budget
Delete-budget-alert
Delete-budget-alert
Delete-canvas
Delete-canvas
Delete-cost-alert
Delete-cost-alert
Delete-cost-report
Delete-cost-report
Delete-dashboard
Delete-dashboard
Delete-financial-commitment-report
Delete-financial-commitment-report
Delete-folder
Delete-folder
Delete-network-flow-report
Delete-network-flow-report
Delete-recommendation-view
Delete-recommendation-view
Delete-report-forecast
Delete-report-forecast
Delete-report-notification
Delete-report-notification
VANTAGE_MCP_DELETE_REPORT_NOTIFICATIONDeletes 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.Input Parameters
Delete-resource-report
Delete-resource-report
Delete-scenario-model
Delete-scenario-model
Delete-team
Delete-team
Delete-virtual-tag-config
Delete-virtual-tag-config
Delete-virtual-tag-config-value
Delete-virtual-tag-config-value
Get-anomaly
Get-anomaly
Get-billing-rule
Get-billing-rule
Get-budget
Get-budget
VANTAGE_MCP_GET_BUDGETGets 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>Input Parameters
Get-budget-alert
Get-budget-alert
Get-business-metric
Get-business-metric
Get-business-metric-forecasted-values
Get-business-metric-forecasted-values
VANTAGE_MCP_GET_BUSINESS_METRIC_FORECASTED_VALUESGet 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.Input Parameters
Get-business-metric-values
Get-business-metric-values
VANTAGE_MCP_GET_BUSINESS_METRIC_VALUESGet 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.Input Parameters
Get-canvas
Get-canvas
VANTAGE_MCP_GET_CANVASGets 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>Input Parameters
Get-cost-alert
Get-cost-alert
VANTAGE_MCP_GET_COST_ALERTGets 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.Input Parameters
Get-cost-alert-event
Get-cost-alert-event
Get-cost-provider-accounts
Get-cost-provider-accounts
VANTAGE_MCP_GET_COST_PROVIDER_ACCOUNTSGet 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.Input Parameters
Get-cost-report
Get-cost-report
VANTAGE_MCP_GET_COST_REPORTGets 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.Input Parameters
Get-cost-report-forecast
Get-cost-report-forecast
VANTAGE_MCP_GET_COST_REPORT_FORECASTGiven 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>Input Parameters
Get-dashboard
Get-dashboard
VANTAGE_MCP_GET_DASHBOARDGets 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>Input Parameters
Get-financial-commitment-report
Get-financial-commitment-report
VANTAGE_MCP_GET_FINANCIAL_COMMITMENT_REPORTGets 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.Input Parameters
Get-folder
Get-folder
Get-myself
Get-myself
VANTAGE_MCP_GET_MYSELFGet 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-network-flow-report
Get-network-flow-report
VANTAGE_MCP_GET_NETWORK_FLOW_REPORTGets a saved Network Flow Report by token. Open in the console at https://console.vantage.sh/go/<token>.Input Parameters
Get-provider-resource
Get-provider-resource
VANTAGE_MCP_GET_PROVIDER_RESOURCEGet 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
Input Parameters
Get-recommendation-details
Get-recommendation-details
VANTAGE_MCP_GET_RECOMMENDATION_DETAILSGet 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
Input Parameters
Get-recommendation-resource-details
Get-recommendation-resource-details
VANTAGE_MCP_GET_RECOMMENDATION_RESOURCE_DETAILSGet comprehensive details about a specific infrastructure resource within a cost optimization recommendation, including the exact actions recommended for that resource.This tool provides the deepest level of detail about a single resource that’s part of a recommendation. The response includes:- Complete resource identification (resource ID, type, region, account)
- Current configuration and specifications
- Resource utilization metrics and patterns
- Specific recommendation actions for this resource
- Estimated cost savings for implementing the recommendations
- CLI command for remediating the recommendation
- Implementation complexity and effort estimates
- Detailed metadata specific to the resource type and recommendation category
- For rightsizing recommendations: shows current vs. recommended instance types, CPU/memory utilization data
- For unused resources: shows usage patterns, last activity, and safe termination recommendations
- For storage optimization: shows current vs. recommended volume types, IOPS usage, throughput patterns
- For Reserved Instance recommendations: shows usage patterns, recommended commitment levels
Input Parameters
Get-recommendation-resources
Get-recommendation-resources
VANTAGE_MCP_GET_RECOMMENDATION_RESOURCESGet a paginated list of all infrastructure resources affected by a specific cost optimization recommendation.This tool returns the actual cloud resources (instances, volumes, load balancers, etc.) that are involved in a recommendation. Each resource entry includes:- Resource token (unique identifier for the specific resource)
- Resource type (e.g., EC2 instance, EBS volume, RDS instance)
- Resource identifier (instance ID, volume ID, etc.)
- Current configuration details
- Resource-specific metadata
- For EC2 rightsizing recommendations: shows the specific instances that are over-provisioned
- For unused resource recommendations: shows the idle instances, volumes, or load balancers
- For Reserved Instance recommendations: shows the usage patterns and instance families
- For storage optimization: shows the volumes that could be optimized
Input Parameters
Get-recommendation-view
Get-recommendation-view
Get-report-forecast
Get-report-forecast
Get-report-notification
Get-report-notification
VANTAGE_MCP_GET_REPORT_NOTIFICATIONGets a specific Report Notification by its token.Use this tool when you already have a report notification token, such as one returned by list-report-notifications or referenced in Vantage. The response includes the notification title, Cost Report token, recipients, delivery channels, frequency, and tracked change type.Do not use this for Cost Alerts, budget alerts, threshold alerts, or spend-limit notifications.Input Parameters
Get-resource-report
Get-resource-report
VANTAGE_MCP_GET_RESOURCE_REPORTGets a specific resource report by its token. The token of a report can be used to generate a link to the resource report in the Vantage Web UI: https://console.vantage.sh/go/<token>Input Parameters
Get-scenario-model
Get-scenario-model
VANTAGE_MCP_GET_SCENARIO_MODELGet a specific ScenarioModel by token. ScenarioModels define future-cost adjustments that can be assigned to Cost Report forecasts. Use list-scenario-models to discover tokens. The token can also be used with update-scenario-model, delete-scenario-model, and report-forecast tools. Requires Scenario Models (Enterprise). A 403 means the account is not entitled.Input Parameters
Get-team
Get-team
Get-team-members
Get-team-members
Get-teams
Get-teams
Get-user
Get-user
Get-users
Get-users
Get-virtual-tag-config
Get-virtual-tag-config
Get-virtual-tag-config-value
Get-virtual-tag-config-value
Get-workspace
Get-workspace
List-annotations
List-annotations
List-anomalies
List-anomalies
VANTAGE_MCP_LIST_ANOMALIESGiven a token of a Cost Report, look for anomalies in the report. You may optionally pass a Provider, like AWS to filter on. If you do pass a Provider, you can futher filter on a Service, like EC2 or S3. 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>Input Parameters
List-audit-logs
List-audit-logs
VANTAGE_MCP_LIST_AUDIT_LOGSList audit logs visible to the authenticated Vantage access token. Audit logs provide a chronological history of supported changes to user-facing resources in Vantage, such as cost reports, virtual tags, segments, recommendation commitments, and other workspace-related objects.Results are returned in reverse chronological order (newest first).Each audit log entry can include:- The audit log token
- The affected object’s token, type, and title
- The event (
record_created,record_updated, orrecord_destroyed) - The source of the action (
console,api, orfinops_agent) - The user display name, when available
- The workspace title and workspace token, when available
- The timestamp when the audit log was created
- Field-level change data in
changed_valuesandunchanged_values
- Creating, updating, or deleting cost reports
- Modifying report filters or related configuration
- Creating, updating, or deleting virtual tags
- Updating recommendation commitments
- Creating, updating, or deleting segments
page parameter starting at 1. You can also pass limit; if omitted, the API defaults to 100 results per page.Audit logs can be filtered by:user: numeric user ID associated with the actionworkspace_token: workspace tokenaction:create,update, ordeleteobject_type:cost_report,virtual_tag,recommendation_commitment, orsegmentobject_name: exact object titleobject_token: audited object tokensource:console,api, orfinops_agentstart_dateandend_date: YYYY-MM-DD dates such as2024-06-01token: audit log token
- Compliance and security review
- Debugging change history
- Change management for reports and configuration
- Monitoring actions taken through the API or the Finops Agent
Input Parameters
List-billing-rules
List-billing-rules
List-budget-alerts
List-budget-alerts
List-budgets
List-budgets
VANTAGE_MCP_LIST_BUDGETSList all budgets available in the Vantage account. Budgets help track spending against predefined limits. Use the page value of 1 to start. A budget is built against a Cost Report. The Budget objects returned by this tool will have a “cost_report_token” field that contains the token of the Cost Report. The Cost Report has the “filter” field to know what is the range of providers & services that the budget is tracking. When a user is looking at a Cost Report for a specific date range, they can decide if the providers and services spend is higher than desired by looking at the budgets for that report and the date range of the budget. 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>Input Parameters
List-business-metric-labels
List-business-metric-labels
VANTAGE_MCP_LIST_BUSINESS_METRIC_LABELSList distinct label values for a BusinessMetric. For multi-label metrics, values are flattened across label keys. Use this before get-business-metric-values when a label-dependent request does not provide confirmed exact label values. This endpoint is paginated. If the user needs the complete set of labels, keep calling this tool with pagination.nextPage until pagination.hasNextPage is false.Input Parameters
List-business-metrics
List-business-metrics
VANTAGE_MCP_LIST_BUSINESS_METRICSList all BusinessMetrics available to the current Vantage API token. Use page 1 when calling this tool for the first time. If the user asks for all BusinessMetrics or needs to search across the full set, keep calling this tool with pagination.nextPage until pagination.hasNextPage is false. BusinessMetrics represent business KPIs, such as requests, users, or revenue, that can be attached to Cost Reports for per-unit cost analysis. The token of a BusinessMetric can be used with get-business-metric, list-business-metric-labels, get-business-metric-values, and get-business-metric-forecasted-values.Input Parameters
List-canvases
List-canvases
VANTAGE_MCP_LIST_CANVASESList all saved Canvases available in the Vantage account. Canvases are AI-generated cost analysis views created from natural language prompts. Use the page value of 1 to start. 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>Input Parameters
List-cost-alert-events
List-cost-alert-events
List-cost-alerts
List-cost-alerts
VANTAGE_MCP_LIST_COST_ALERTSList Cost Alerts available in the Vantage account. Cost Alerts are threshold-based spending alerts for Cost Reports.Use this tool when a user asks to list, show, view, or find cost alerts, spending alerts, budget alerts, threshold alerts, or spend-limit notifications.Do not use this for Report Notifications, scheduled report summaries, or recurring Cost Report delivery.Input Parameters
List-cost-integrations
List-cost-integrations
VANTAGE_MCP_LIST_COST_INTEGRATIONSList all cost provider integrations available to provide costs data from and their associated accounts. Integrations are the cost providers that Vantage is configured to connect to and pull cost data from. If a user wants to see their providers in the Vantage Web UI, they can visit https://console.vantage.sh/settings/integrationsNote that when ‘provider’ is ‘custom_provider’, that has a special case. When doing a VQL query for custom provider, use the ‘token’ you get back. Here is an example, where the token of the custom provider is “accss_crdntl_07171984”: (costs.provider = ‘custom_provider:accss_crdntl_07171984’)Input Parameters
List-cost-providers
List-cost-providers
List-cost-reports
List-cost-reports
VANTAGE_MCP_LIST_COST_REPORTSList all cost reports available. Cost reports are already created reports authored by a user in Vantage. If the user isn’t asking about a specific report, it’s better to use the query-costs tool. When you first call this function, use the “Page” parameter of 1. The ‘Title’ of a report is a good way to know what the report is about. The ‘filter’ of a report also gives clues to the data it provides. The ‘token’ of a report is a unique identifier for the report. It can be used to generate a link to the report in the Vantage Web UI. If a user wants to see a report, you can link them like this: https://console.vantage.sh/go/<token> Vantage offers data related to a cost report: Forecasts. The same report token can be used on the get-cost-report-forecast tool and Vantage will forecast future costs.Input Parameters
List-costs
List-costs
VANTAGE_MCP_LIST_COSTSList the cost items inside a report. The Token of a Report must be provided. Use the page value of 1 to start. 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>The DateBin parameter controls the time granularity of returned results. When DateBin=day you get a record for each service spend on that day. For DateBin=week you get one entry per week, with the accrued_at field set to the first day of the week, but the spend item represents spend for a full week. Same with DateBin=month, each record returned covers a month of data. This lets you get answers with processing fewer records. If omitted, the API uses the cost report’s configured date bin, or day if the report has no override.Cost settings (credits, refunds, discounts, tax, amortization, etc.) default to the report’s own settings. Only provide these parameters if you need to override the report’s defaults.Use settings_aggregate_by to choose the metric: cost (default), usage, or count. When aggregate_by is count, the response includes total_count and counts (date-binned distinct Group By permutation counts for the full requested period). Count is not supported for segment reports.Input Parameters
List-cost-services
List-cost-services
VANTAGE_MCP_LIST_COST_SERVICESList cost service display names for a workspace. These names may NOT match VQL costs.service identifiers used in query-costs filters. Do not copy names from this tool directly into VQL. Use vql_info or costs.service values from a broad query-costs probe instead.Input Parameters
List-dashboards
List-dashboards
VANTAGE_MCP_LIST_DASHBOARDSList all dashboards available in the Vantage account. Dashboards provide visualizations of cost data. Use the page value of 1 to start. The token of a dashboard can be used to link the user to the dashboard in the Vantage Web UI. Build the link like this: https://console.vantage.sh/go/<token>Input Parameters
List-financial-commitment-reports
List-financial-commitment-reports
List-folders
List-folders
VANTAGE_MCP_LIST_FOLDERSList folders for Cost Reports or Resource Reports, optionally filtering by title, Workspace, or folder type. Use CostFolder for Cost Report folders and ProviderResourceFolder for Resource Report folders; folder tokens link to https://console.vantage.sh/go/<token>.Input Parameters
List-network-flow-reports
List-network-flow-reports
List-provider-resources
List-provider-resources
VANTAGE_MCP_LIST_PROVIDER_RESOURCESList infrastructure provider resources (instances, volumes, load balancers, etc.) from your cloud accounts. Resources can be fetched either from a specific Resource Report or by using VQL filters.When using a resource_report_token, you get the pre-filtered resources from that report. When using VQL filters with workspace_token, you can dynamically query resources across your infrastructure. Provide either resource_report_token or filter (not both). When using filter, workspace_token is required.VQL for Resource Reports enables filtering using two primary namespaces:Resources Namespace - Access infrastructure attributes:- resources.provider (AWS, GCP, Azure, etc.)
- resources.region (geographic location codes)
- resources.account_id and resources.provider_account_id
- resources.type (resource classification)
- resources.label and resources.uuid (identifiers)
- resources.metadata (detailed resource properties using ->> operator, e.g., resources.metadata->>‘architecture’)
- tags.name (tag key)
- tags.value (tag content)
- Pattern Matching: LIKE and NOT LIKE for substring searches
- Comparisons: IN/NOT IN for list evaluation; !=, <, >, <=, >= for values
- Metadata Queries: >> operator for resource metadata (e.g., resources.metadata->>‘architecture’)
- Multi-provider: (resources.provider IN (‘aws’, ‘gcp’))
- Regional: (resources.provider = ‘aws’ AND resources.region = ‘us-east-1’)
- Resource type: (resources.provider = ‘aws’ AND resources.type = ‘aws_instance’)
- Metadata: (resources.provider = ‘aws’ AND resources.metadata->>‘architecture’ = ‘x86_64’)
- Tags: (resources.provider = ‘aws’ AND tags.name = ‘environment’ AND tags.value = ‘production’)
- Untagged resources: (resources.provider = ‘aws’ AND tags.name = NULL)
Input Parameters
List-recommendations
List-recommendations
VANTAGE_MCP_LIST_RECOMMENDATIONSList all cost optimization recommendations available in the Vantage account. Recommendations are AI-powered suggestions that help identify opportunities to reduce costs and optimize cloud spending across your infrastructure.Use the page value of 1 to start pagination.Recommendations include various types such as:- EC2 rightsizing (resize overprovisioned instances)
- Unused financial commitments (unused Reserved Instances or Savings Plans)
- Idle resources (running but unused instances, volumes, load balancers)
- Storage optimization (EBS volume type recommendations)
- Reserved Instance and Savings Plan purchase recommendations
- Potential cost savings amount
- Description of what can be optimized
- Provider and service information
- Number of resources affected
- Current status (open, resolved, dismissed)
- Status (open shows active recommendations, resolved shows implemented ones, dismissed shows ignored ones)
- Cloud provider via provider (single) or provider_ids (multiple; requires workspace_token) — only use these when the user explicitly specifies cloud providers; do not infer or default to all providers
- Specific workspace via workspace_token
- Provider account ID via provider_account_id (single) or account_ids (multiple; requires workspace_token)
- Billing account via billing_account_ids (requires workspace_token)
- Region via regions (requires workspace_token)
- Tag key/value pair via tag_key + tag_value (both required together; requires workspace_token) — use this when users ask about recommendations for a specific virtual tag, e.g. “recommendations for department=engineering”
- Date range via start_date + end_date in YYYY-MM-DD format (both required together; requires workspace_token)
- Minimum monthly potential savings via min_savings
- Recommendation type via type (case-insensitive fuzzy matching; e.g. “AWS recommendations” -> type=aws; “EC2 rightsizing” -> type=aws:ec2:rightsizing)
Input Parameters
List-recommendation-views
List-recommendation-views
VANTAGE_MCP_LIST_RECOMMENDATION_VIEWSList all recommendation views available in the Vantage account. Recommendation views are saved filters for cost optimization recommendations. Use the page value of 1 to start. The title of a recommendation view is a good way to understand what optimization scope it represents. The token of a recommendation view is its unique identifier and can be used to link the user to the view in the Vantage Web UI. Build the link like this: https://console.vantage.sh/go/<token> The workspace token, date range, providers, accounts, regions, and tag fields provide additional context about which recommendations are included in the view.Input Parameters
List-report-forecasts
List-report-forecasts
VANTAGE_MCP_LIST_REPORT_FORECASTSList scenario-model ReportForecasts for a Cost Report. ReportForecasts assign ScenarioModels (and optionally a BusinessMetric) to a Cost Report for planning views. Use page 1 when calling this tool for the first time. Keep calling with pagination.nextPage until pagination.hasNextPage is false when listing all forecasts. The token of a ReportForecast can be used with get-report-forecast, update-report-forecast, and delete-report-forecast. Requires Scenario Models (Enterprise). A 403 means the account is not entitled.Input Parameters
List-report-notifications
List-report-notifications
VANTAGE_MCP_LIST_REPORT_NOTIFICATIONSList Report Notifications available in the Vantage account. Report Notifications are scheduled deliveries of Cost Report summaries to users, Slack channels, or Microsoft Teams channels.Use this tool when a user asks to list, show, view, or find scheduled report notifications or recurring Cost Report summaries. Use the page value of 1 to start.Do not use this for Cost Alerts, budget alerts, threshold alerts, or spend-limit notifications. Cost Alerts are threshold-based spending alerts; Report Notifications are scheduled report deliveries.Input Parameters
List-resource-report-columns
List-resource-report-columns
List-resource-reports
List-resource-reports
VANTAGE_MCP_LIST_RESOURCE_REPORTSList all resource reports available. Resource reports are already created reports authored by a user in Vantage. When you first call this function, use the “Page” parameter of 1. The ‘Title’ of a report is a good way to know what the report is about. The ‘filter’ of a report also gives clues to the data it provides. The ‘token’ of a report is a unique identifier for the report. It can be used to generate a link to the report in the Vantage Web UI. If a user wants to see a report, you can link them like this: https://console.vantage.sh/go/<token>Input Parameters
List-scenario-models
List-scenario-models
VANTAGE_MCP_LIST_SCENARIO_MODELSList ScenarioModels available to the current Vantage API token. ScenarioModels define future-cost adjustments (dollar or percent) that can be assigned to Cost Report forecasts via report-forecast tools. Use page 1 when calling this tool for the first time. If the user asks for all ScenarioModels, keep calling with pagination.nextPage until pagination.hasNextPage is false. The token of a ScenarioModel can be used with get-scenario-model, update-scenario-model, delete-scenario-model, and create-report-forecast / update-report-forecast. Requires Scenario Models (Enterprise). A 403 means the account is not entitled.Input Parameters
List-tag-values
List-tag-values
List-unit-costs
List-unit-costs
VANTAGE_MCP_LIST_UNIT_COSTSRetrieve the unit costs for a given CostReport, with optional paging, date filters, and ordering.Input Parameters
List-virtual-tag-configs
List-virtual-tag-configs
List-workspaces
List-workspaces
VANTAGE_MCP_LIST_WORKSPACESList all Workspaces available to the authenticated API token. Workspaces are isolated environments within Vantage for organizing cost data and access control across teams.Use get-myself to see the user’s default workspace. Use get-workspace to retrieve details for a specific workspace.Input Parameters
Query-costs
Query-costs
VANTAGE_MCP_QUERY_COSTSQuery for costs in a Vantage Account. These are independent of a cost reports. Use Vantage VQL to structure a query. Queries must be scoped to a Workspace. Use the get-myself tool to know about available workspaces, and the get-cost-integrations tool to know about available cost providers. If the user didn’t tell you a workspace it is best to ask them than to guess it. It’s best to set a date range of 30 days unless the user specifically wants to query for a longer time period.When a user asks for data from an account, use the “get-cost-provider-accounts” tool to match a name to an account. With that result, always use the account_id in the account_id parameter for this tool.Here is some more detailed info on using VQL: 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. To query on a cost provider, use this syntax: (costs.provider = ‘<provider name>’). The provider name must come from the list-cost-providers tool. To query on a cost service, use this syntax: (costs.provider = ‘<provider name>’ AND costs.service = ‘<service name>’). For AWS, costs.service must be a CUR identifier (e.g. ‘AmazonEC2’, ‘AmazonVPC’, ‘AWSDirectConnect’). Use vql_info to resolve aliases — not display names from list-cost-services. If a query returns no rows, run one broad probe query first (provider only, date_bin=month, wide date range) to learn available months and service identifiers before retrying with a narrower filter. For month-over-month comparisons, span both months in start_date/end_date with date_bin=month and settings_show_previous_period=true instead of separate queries per month. Prefer one query-costs call with all needed groupings (e.g. service, account_id, tag:<key>) over multiple calls that only change groupings. You can only filter against one cost provider at a time. If you want to query for costs from two providers, you need to use the OR operator. Example: ((costs.provider = ‘aws’) OR (costs.provider = ‘azure’)) You can otherwise use the IN system to compare against a list of items, like this: (costs.provider = ‘aws’ AND costs.service IN (‘AWSQueueService’, ‘AWSLambda’)) To filter within a cost provider, keep the cost provider part and add a AND section, example: (costs.provider = ‘aws’ AND costs.service = ‘AmazonRDS’) Many costs have tags on them. A tag is a “name” and one or more values. To find an AWS cost that has a tag of “environment” the value “production”, use this syntax: (costs.provider = ‘aws’ AND tags.name = ‘environment’ AND tags.value = ‘production’) You can also query for any value of the “environment” tag, like this: (costs.provider = ‘aws’ AND tags.name = ‘environment’) Items without a tag can also be filtered, example: (costs.provider = ‘aws’ AND tags.name = NULL) Parenthesis can be nested. Here we surround an OR clause to look for either of two values for a tag: (costs.provider = ‘aws’ AND tags.name = ‘environment’ AND (tags.value = ‘dev’ OR tags.value = ‘staging’)) A user can have more than one provider account. They can filter on provider accounts if they supply you with the account id. Example: (costs.provider = ‘aws’ AND costs.account_id = ‘1000000717’) You can also combine top-level queries to find for two providers: ((costs.provider = ‘datadog’) OR (costs.provider = ‘azure’)) Some cost providers operate in a specific region, you can filter using the costs.region field. Example: (costs.provider = ‘aws’ AND costs.region = ‘us-east-1’) Note that when users want to query a Custom Provider, that has a special case. When doing a VQL query for custom provider, use the ‘token’ you get back from the ‘list-cost-integrations’ tool. Here is an example, where the token of the custom provider is “accss_crdntl_07171984”: (costs.provider = ‘custom_provider:accss_crdntl_07171984’)The DateBin parameter controls the time granularity of returned results. When DateBin=day you get a record for each service spend on that day. For DateBin=week you get one entry per week, with the accrued_at field set to the first day of the week, but the spend item represents spend for a full week. Same with DateBin=month, each record returned covers a month of data. This lets you get answers with processing fewer records. If omitted, DateBin defaults to day.Cost settings (credits, refunds, discounts, tax, amortization, etc.) default to the workspace’s default report settings. Only provide these parameters if you need to override those defaults.Use settings_aggregate_by to choose the metric: cost (default), usage, or count. When aggregate_by is count, the response includes total_count and counts (date-binned distinct Group By permutation counts for the full requested period).Input Parameters
Query-financial-commitment-report-costs
Query-financial-commitment-report-costs
VANTAGE_MCP_QUERY_FINANCIAL_COMMITMENT_REPORT_COSTSQuery cost data for a Financial Commitment Report. Omit date_bin, groupings, filter, and on_demand_costs_scope to use the report’s saved configuration.DateBin controls time granularity. When DateBin=day each record represents one day; week and month behave similarly with accrued_at set to the period start. Hourly costs are limited to 14 days. If omitted, the report’s configured date bucket is used.Input Parameters
Query-network-flow-logs
Query-network-flow-logs
VANTAGE_MCP_QUERY_NETWORK_FLOW_LOGSQueries aggregated network flow log data (costs and bytes). Pass a saved report token or an ad hoc filter. Unlike create/update, custom date ranges use start_date and end_date without date_interval=custom.Input Parameters
Remove-team-member
Remove-team-member
Submit-user-feedback
Submit-user-feedback
Update-annotation
Update-annotation
Update-anomaly
Update-anomaly
Update-billing-rule
Update-billing-rule
VANTAGE_MCP_UPDATE_BILLING_RULEUpdates an existing Billing Rule. You can update the title, dates, and type-specific fields. Type-specific fields:- Exclusion: charge_type
- Adjustment: percentage, service, category
- Charge/Credit: service, category, sub_category, amount, start_date
- Custom: sql_query
Input Parameters
Update-budget
Update-budget
VANTAGE_MCP_UPDATE_BUDGETUpdates an existing Budget. You can update the name, linked Cost Report, child Budget tokens for hierarchical budgets, period cadence, or budget periods.Input Parameters
Update-budget-alert
Update-budget-alert
VANTAGE_MCP_UPDATE_BUDGET_ALERTUpdate an existing Budget Alert’s monitored Budgets, percentage threshold, monthly time window, or recipients. Budget Alerts monitor Budget objects.Input Parameters
Update-canvas
Update-canvas
Update-cost-alert
Update-cost-alert
VANTAGE_MCP_UPDATE_COST_ALERTUpdates an existing Cost Alert. Use to change the title, threshold, interval, monitored Cost Reports, or notification destinations.Use list-cost-alerts or get-cost-alert to find the cost_alert_token. Do not use this for Report Notifications or recurring Cost Report delivery.Input Parameters
Update-cost-report
Update-cost-report
VANTAGE_MCP_UPDATE_COST_REPORTUpdates an existing Cost Report. Use to change the title, VQL filter, groupings, date range, chart type, folder, report settings, or attached business metrics.Do not use create-cost-report (creates a new report) or get-cost-report (reads without changing). Use list-cost-reports or get-cost-report to find the cost_report_token.Input Parameters
Update-dashboard
Update-dashboard
VANTAGE_MCP_UPDATE_DASHBOARDUpdates an existing Dashboard. You can update the title, widgets, saved filters, and date range settings.Input Parameters
Update-financial-commitment-report
Update-financial-commitment-report
VANTAGE_MCP_UPDATE_FINANCIAL_COMMITMENT_REPORTUpdates an existing Financial Commitment Report. Use this to change the report title, VQL filter, date range, date bucket, on-demand costs scope, or grouping dimensions.Date ranges can be set with either:- date_interval, or
- start_date and end_date.
Input Parameters
Update-folder
Update-folder
Update-network-flow-report
Update-network-flow-report
Update-recommendation-view
Update-recommendation-view
VANTAGE_MCP_UPDATE_RECOMMENDATION_VIEWUpdates an existing Recommendation View. Use this to change the view title or the filters applied to saved recommendation views.Filters can be scoped by provider, billing account, cloud account, region, tag key/value, and recommendation creation date range.Dates must be YYYY-MM-DD formatted. Tag filters should use tag_key and tag_value together.Input Parameters
Update-report-forecast
Update-report-forecast
VANTAGE_MCP_UPDATE_REPORT_FORECASTUpdate a scenario-model ReportForecast. Providing scenario_model_tokens replaces the assigned models. Send business_metric_token as null to clear the BusinessMetric. Use set_as_default to make this the Cost Report default forecast. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot update the Cost Report.Input Parameters
Update-report-notification
Update-report-notification
VANTAGE_MCP_UPDATE_REPORT_NOTIFICATIONUpdates an existing Report Notification in Vantage.Use this tool to change a scheduled Cost Report notification’s title, Cost Report, recipients, Slack or Microsoft Teams channels, delivery frequency, or tracked change type. Report Notifications deliver recurring Cost Report summaries on a daily, weekly, or monthly cadence.Do not use this for Cost Alerts, budget alerts, threshold alerts, or spend-limit notifications. Cost Alerts manage spend thresholds; Report Notifications manage scheduled report delivery.Input Parameters
Update-resource-report
Update-resource-report
VANTAGE_MCP_UPDATE_RESOURCE_REPORTUpdates an existing Resource Report. Use to change the title, VQL filter, table columns, or folder.Do not use create-resource-report (creates a new report) or get-resource-report (reads without changing). Use list-resource-reports or get-resource-report to find the resource_report_token.Input Parameters
Update-scenario-model
Update-scenario-model
VANTAGE_MCP_UPDATE_SCENARIO_MODELUpdate an existing ScenarioModel. Providing periods replaces the full period set. Use null for priority, provider, service, or period end_at to clear those values. Requires Scenario Models (Enterprise). A 403 means the account is not entitled or the caller cannot update the model.Input Parameters
Update-team
Update-team
Update-virtual-tag-config
Update-virtual-tag-config
VANTAGE_MCP_UPDATE_VIRTUAL_TAG_CONFIGUpdates an existing Virtual Tag’s config-level settings or complete ordered mappings/values. Supplying values replaces the entire list in that order, and an empty array clears it; use the value-level tools to append, partially edit, or delete one mapping.Input Parameters
Update-virtual-tag-config-value
Update-virtual-tag-config-value