Vantage MCP for AI agents
Agents read Vantage MCP at once. Changes and sends are held for a person's approval by default.
About Vantage MCP
Vantage MCP lets agents analyze authorized cloud costs, reports, resources, tags, budgets, anomalies, and optimization recommendations, and perform supported FinOps management actions.
What an agent can do in Vantage MCP
Every Vantage MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Vantage MCP without asking first. 71 actions.
- Get-anomalyGets a specific anomaly alert by its token.
- Get-billing-ruleGets a specific Billing Rule by its token. Returns details about the rule including its type, configuration, and applicable dates.
- 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 Van
- Get-budget-alertGet a specific Budget Alert by token. Budget Alerts monitor Budget objects.
- Get-business-metricGet 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-me
- 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 YYY
- 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
- 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
- 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 spen
- Get-cost-alert-eventGets a specific Cost Alert event by its token. Use after list-cost-alert-events when you need the full trigger record.
- 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.
- 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 wit
Show all 71
- 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 da
- 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>
- 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.
- Get-folderGets a specific Folder by its token.
- 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 u
- Get-network-flow-reportGets a saved Network Flow Report by token. Open in the console at https://console.vantage.sh/go/<token>.
- 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, configur
- 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
- 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
- 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.) th
- Get-recommendation-viewGets a specific recommendation view by its token.
- Get-report-forecastGet a specific scenario-model ReportForecast by token. Use list-report-forecasts to discover tokens for a Cost Report. Requires Scenario Models (Enterprise). A 403 means the account is not entitled.
- 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 respo
- 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>
- 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 u
- Get-teamGets a specific team with its token.
- Get-team-membersReturn the members of a Team, including each user's name, email, token, and Team role.
- Get-teamsReturn all Teams that the user has access to.
- Get-userGets a specific User by their token. Use get-users to discover user tokens in the workspace.
- Get-usersReturn all Users that the user can see in the workspace. Requires account owner permissions; non-owners receive 403 from the API.
- Get-virtual-tag-configReturns one existing Virtual Tag (Virtual Tag Config) with its complete ordered mappings/values. Use this to show all values on a tag and discover value tokens before editing or reordering.
- Get-virtual-tag-config-valueReturns one mapping/value from an existing Virtual Tag Config, including its filter and allocation settings. Use this to inspect one mapping before editing it.
- Get-workspaceGets a specific Workspace by its token. Workspaces are isolated environments within Vantage for organizing cost data and access control across teams.
- List-annotationsList report annotations available to the authenticated Vantage access token, ordered from newest to oldest. Optionally filter annotations to a specific Cost Report.
- 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
- 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 ta
- List-billing-rulesList all billing rules available in the Vantage account. Billing rules allow you to adjust, exclude, or add charges to your cost data. Use the page value of 1 to start.
- List-budget-alertsList Budget Alerts in Vantage. Budget Alerts notify users or connected channels when one or more Budgets reach a percentage threshold during a monthly time window.
- 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
- 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 pro
- 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 s
- 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 c
- List-cost-alert-eventsList events for a Cost Alert. Events are individual alert trigger records and can be filtered by Cost Report token.
- 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 a
- 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
- List-cost-providersList of cost providers available to query for a given Workspace. Can be used to filter costs down to a specific provider in VQL queries.
- 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
- 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
- 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 o
- 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 das
- List-financial-commitment-reportsList all financial commitment reports available in the Vantage account. Use the page value of 1 to start.
- 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 folde
- List-network-flow-reportsLists saved Network Flow Reports. Use get-network-flow-report for a report's configuration.
- 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. Whe
- 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 acr
- 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 recommend
- 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 fo
- 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
- List-resource-report-columnsList available columns for a resource type. The resource_type is a required parameter, and must be a valid VQL resource type name.
- 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 repo
- 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 tool
- List-tagsList tags that can be used to filter costs and cost reports. Tags are associated with one or more Cost Providers. Tags can be edited in the Vantage Web UI, or have further details displayed there. Lin
- List-tag-valuesList values for a tag key. The argument is `key` (the tag key name); the API response fields use `tag_value`. Requires integration settings permission; callers without it receive 403 from the API.
- List-unit-costsRetrieve the unit costs for a given CostReport, with optional paging, date filters, and ordering.
- List-virtual-tag-configsLists or searches the Virtual Tags (Virtual Tag Configs) the current API token can access, including every mapping/value. Use this to discover config and value tokens or find a tag by key.
- 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 us
- 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 availa
- 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=
- 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=cu
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 63 actions.
- Add-team-memberAdd a user to a Team by email address and assign their Team role.
- Create-annotationCreate 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.
- 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
- 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.
- 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.
- 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
- 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,
- 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 wit
- 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
- 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
- Create-folderCreate a folder for organizing Cost Reports or Resource Reports. Set type to CostFolder for Cost Reports or ProviderResourceFolder for Resource Reports.
- Create-network-flow-reportCreates a saved Network Flow Report for analyzing cloud network traffic by cost or bytes.
Show all 63
- 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, ta
- 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.
- 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 c
- 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 li
- 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 Scenar
- Create-teamCreate a Team and optionally associate it with Workspaces, users, and a default Dashboard.
- 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
- Create-virtual-tag-config-valueAdds 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-workspaceCreate a new Workspace in Vantage. Workspaces are isolated environments for organizing cost data and access control across teams.
- Delete-annotationDelete an Annotation by its token. This action is irreversible. Use list-annotations to find the annotation_token.
- Delete-billing-ruleDeletes a Billing Rule by its token. This action is irreversible.
- Delete-budgetDeletes a Budget by its token. This action is irreversible.
- Delete-budget-alertDelete a Budget Alert by token. This permanently removes the alert without deleting its monitored Budgets.
- Delete-canvasDeletes a Canvas by its token. This action is irreversible.
- Delete-cost-alertDeletes a Cost Alert by its token. This action is irreversible.
- Delete-cost-reportDeletes a cost report by its token. This action is irreversible.
- Delete-dashboardDeletes a Dashboard by its token. This action is irreversible.
- Delete-financial-commitment-reportDeletes a financial commitment report by its token. This action is irreversible.
- Delete-folderDeletes a Folder. Reports within the Folder will not be deleted.
- Delete-network-flow-reportDeletes a Network Flow Report by token.
- Delete-recommendation-viewDeletes a recommendation view by its token. This action is irreversible.
- Delete-report-forecastDelete 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-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
- Delete-resource-reportDeletes a resource report by its token. This action is irreversible.
- Delete-scenario-modelDelete 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
- Delete-teamDelete a Team.
- Delete-virtual-tag-configDeletes 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-valueDeletes exactly one mapping/value from an existing Virtual Tag Config, not the containing tag. Remaining values are preserved without replacement or reordering.
- Remove-team-memberRemove a user from a Team without deleting the user.
- Submit-user-feedbackSubmit feedback on using the Vantage MCP Server. Ask the user if they'd like to provide feedback any time you sense they might be frustrated. Stop suggesting if they say they're not interested in prov
- Update-annotationUpdate the title, date, message, or associated Cost Reports of an existing Annotation. Providing report_tokens replaces all existing Report associations. Use list-annotations to find the annotation_to
- Update-anomalyUpdates an existing anomaly alert by its token. Use this to change the status of an anomaly alert (e.g. to archive or ignore it) and optionally provide feedback.
- 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:
- Update-budgetUpdates an existing Budget. You can update the name, linked Cost Report, child Budget tokens for hierarchical budgets, period cadence, or budget periods.
- Update-budget-alertUpdate an existing Budget Alert's monitored Budgets, percentage threshold, monthly time window, or recipients. Budget Alerts monitor Budget objects.
- Update-canvasUpdates an existing Canvas. You can update the title, the prompt, or both. Updating the prompt triggers an asynchronous refresh to regenerate the canvas data.
- 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.
- 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
- Update-dashboardUpdates an existing Dashboard. You can update the title, widgets, saved filters, and date range settings.
- 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 ei
- Update-folderUpdates a Folder's title, parent, or SavedFilter tokens. Folder type cannot be changed after creation.
- Update-network-flow-reportUpdates a saved Network Flow Report. Use list-network-flow-reports to discover tokens.
- 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, regi
- 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 th
- 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
- 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 chang
- 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
- Update-teamUpdate a Team's name, description, Workspace and user associations, user role, or default Dashboard.
- 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
- Update-virtual-tag-config-valuePartially edits one mapping/value in an existing Virtual Tag Config. Omitted fields remain unchanged, display_name set to null clears it, and this tool cannot reorder values.
- Update-workspaceUpdate an existing Workspace. You can update the name, currency conversion settings, currency code, and exchange rate date method.
Changes wait in Needs you
Changes and sends in Vantage MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Vantage MCP questions
Can an agent change data in Vantage MCP on its own?
Not by default. Changes and sends in Vantage MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Vantage MCP?
This connector lists 71 read actions. Reads run at once, without waiting for approval.
How does Vantage MCP connect?
It connects with dcr oauth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.