MCP App Store
by KeenEthics

Overview

Vantage is the system of record for allocating and optimizing cloud, SaaS, and AI costs. Vantage has multiple tools for optimizing cloud spend and provides organizations with advanced FinOps workflows and cost governance.

Tools

add-team-member

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

create-annotation

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

create-billing-rule

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

create-budget

ChatGPT
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-budget-alert

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

create-canvas

ChatGPT
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-cost-alert

ChatGPT
Creates a cost alert based on the parameters specified. Cost alerts notify you when spending on one or more cost reports exceeds a specified threshold over a given interval.

create-cost-report

ChatGPT
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-dashboard

ChatGPT
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-dashboard-notification

ChatGPT
Creates a scheduled email of a Dashboard. Recipients are Vantage users or email addresses, not chat channels. Do not use this for Report Notifications, Cost Alerts, or Budget Alerts.

create-financial-commitment-report

ChatGPT
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-folder

ChatGPT
Create a Folder for organizing Cost Reports. Folders can be nested by specifying a parent_folder_token. SavedFilters can be applied to the Folder so that any Cost Report within it inherits those filters.

create-kubernetes-efficiency-report

ChatGPT
Creates a saved Kubernetes Efficiency Report for analyzing workload cost, idle cost, and cost efficiency.

create-network-flow-report

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

create-recommendation-view

ChatGPT
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-report-forecast

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

create-report-notification

ChatGPT
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-resource-report

ChatGPT
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-saved-filter

ChatGPT
Create a Saved Filter for reuse across Cost Reports. The filter uses VQL syntax.

create-scenario-model

ChatGPT
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-team

ChatGPT
Create a Team and optionally associate it with Workspaces, users, and a default Dashboard.

create-virtual-tag-config

ChatGPT
Create a Virtual Tag Config in Vantage. Virtual Tag Configs define a derived (virtual) tag key and a set of values determined by VQL filters. This is useful for normalizing cost attribution (e.g., mapping multiple provider tag formats into a single tag), collapsing noisy tag keys, and optionally overriding provider-supplied tags. You can optionally: - backfill_until: backfill the virtual tag values to an earliest month - collapsed_tag_keys: collapse values for specific underlying tag keys (optionally scoped by provider) - values: define named values via VQL filters, optionally linked to Business Metrics and/or cost metrics

create-virtual-tag-config-value

ChatGPT
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-workspace

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

delete-access-policy

ChatGPT
Delete an Access Policy. Teams it was assigned to lose the cost visibility limits it applied. Requires account owner permissions; other callers receive 403 from the API.

delete-annotation

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

delete-billing-rule

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

delete-budget

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

delete-budget-alert

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

delete-canvas

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

delete-cost-alert

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

delete-cost-report

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

delete-dashboard

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

delete-dashboard-notification

ChatGPT
Deletes a Dashboard Notification and stops its scheduled email. This cannot be undone. Do not use this for Report Notifications, Cost Alerts, or Budget Alerts.

delete-dashboard-widget

ChatGPT
Deletes one Dashboard Widget. The Dashboard remains. This cannot be undone. To delete the whole Dashboard, use delete-dashboard.

delete-financial-commitment-report

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

delete-folder

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

delete-kubernetes-efficiency-report

ChatGPT
Deletes a Kubernetes Efficiency Report by token.

delete-network-flow-report

ChatGPT
Deletes a Network Flow Report by token.

delete-recommendation-view

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

delete-report-forecast

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

delete-report-notification

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

delete-resource-report

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

delete-saved-filter

ChatGPT
Delete a Saved Filter by token.

delete-scenario-model

ChatGPT
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-team

ChatGPT
Delete a Team.

delete-virtual-tag-config

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

delete-virtual-tag-config-value

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

get-anomaly

ChatGPT
Gets a specific anomaly alert by its token.

get-billing-rule

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

get-budget

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

get-budget-alert

ChatGPT
Get a specific Budget Alert by token. Budget Alerts monitor Budget objects.

get-business-metric

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

get-business-metric-forecasted-values

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

get-business-metric-values

ChatGPT
Get historical 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-canvas

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

get-cost-alert

ChatGPT
Gets a specific cost alert by its token.

get-cost-alert-event

ChatGPT
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

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

get-cost-report

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

get-cost-report-forecast

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

get-dashboard

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

get-dashboard-notification

ChatGPT
Returns one Dashboard Notification. Tokens come from list-dashboard-notifications. Do not use this for Report Notifications, Cost Alerts, or Budget Alerts.

get-dashboard-widget

ChatGPT
Returns one Dashboard Widget. Widget tokens come from get-dashboard.

get-financial-commitment-report

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

get-folder

ChatGPT
Gets a specific Folder by its token.

get-kubernetes-efficiency-report

ChatGPT
Gets a saved Kubernetes Efficiency Report by token.

get-myself

ChatGPT
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 workspace for the user and can be used for queries unless told otherwise.

get-network-flow-report

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

get-provider-resource

ChatGPT
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-recommendation-details

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

get-recommendation-resource-details

ChatGPT
Get 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 Use this tool when you need to understand exactly what should be done with a specific resource. For example: - 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 This is the most granular level of recommendation data available and is essential for making informed decisions about implementing specific optimizations. You must have both the recommendation token (from list-recommendations) and the resource token (from get-recommendation-resources) to use this tool.

get-recommendation-resources

ChatGPT
Get 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 Use this tool after getting recommendation details to see exactly which resources need attention. For example: - 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 Each resource has its own token that can be used with get-recommendation-resource-details to get comprehensive information about that specific resource and what actions are recommended. Use pagination (page parameter) to navigate through large numbers of affected resources.

get-recommendation-view

ChatGPT
Gets a specific recommendation view by its token.

get-report-forecast

ChatGPT
Get 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-notification

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

get-resource-report

ChatGPT
Gets 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-saved-filter

ChatGPT
Get a Saved Filter by token, including its VQL filter and associated Cost Report tokens.

get-scenario-model

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

get-team

ChatGPT
Gets a specific team with its token.

get-team-members

ChatGPT
Return the members of a Team, including each user's name, email, token, and Team role.

get-teams

ChatGPT
Return all Teams that the user has access to.

get-user

ChatGPT
Gets a specific User by their token. Use get-users to discover user tokens in the workspace.

get-users

ChatGPT
Return all Users that the user can see in the workspace.

get-virtual-tag-config

ChatGPT
Returns 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-value

ChatGPT
Returns 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-workspace

ChatGPT
Gets a specific Workspace by its token. Workspaces are isolated environments within Vantage for organizing cost data and access control across teams.

list-access-policies

ChatGPT
List the Access Policies on the account, including the cost filter each one applies and the Teams it is assigned to. Requires account owner permissions; other callers receive 403 from the API.

list-annotations

ChatGPT
List report annotations available to the authenticated Vantage access token, ordered from newest to oldest. Optionally filter annotations to a specific Cost Report.

list-anomalies

ChatGPT
Given 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>

list-audit-logs

ChatGPT
List audit logs for actions taken within the Vantage workspace. Audit logs are a chronological record of all changes and activities that occur in your workspace, providing a complete history of who did what, when, and what changed. Audit logs track various types of actions including: - Creating, updating, or deleting cost reports - Modifying report settings, filters, or configurations - Creating, updating, or deleting virtual tags - Commitment actions taken manually or autonomously by the Finops Agent (autonomous cost optimization actions) Each audit log entry contains: - The user or service token (Team) that performed the action - The action type (record_created, record_updated, record_destroyed) - The object that was affected (cost report, virtual tag, commitment, etc.) - The timestamp when the action occurred - What values changed (before and after states) - The source of the action (console, api, developer, finops_agent) - A scoutAction boolean field that indicates if the action was taken by the Finops Agent (Scout), which is particularly relevant for commitment actions to distinguish agent-driven actions from human actions - The workspace where the action took place Use pagination via the "page" parameter starting with 1. The default limit is 100 results per page, which can be adjusted up to 1000. Audit logs can be filtered by: - User ID (to see actions by a specific person or service token (Team)) - Workspace token (to scope to a specific workspace) - Action type (create, update, delete) - Object type (cost_report, virtual_tag, recommendation_commitment) - Object name or token (to track changes to a specific resource) - Source (console, api, developer, finops_agent) - use "finops_agent" to filter for actions specifically taken by the Finops Agent - Date range (start_date and end_date in ISO 8601 format) - Audit log token (to retrieve a specific log entry) Common use cases for audit logs include: - Compliance and security auditing (tracking who made changes) - Debugging issues (seeing what changed before a problem occurred) - Change management (reviewing modifications to reports or configurations) - Activity monitoring (understanding workspace usage patterns) - Distinguishing between human actions and autonomous agent actions (via scoutAction field and finops_agent source filter)

list-billing-rules

ChatGPT
List 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-alerts

ChatGPT
List 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-budgets

ChatGPT
List 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>

list-business-metric-labels

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

list-business-metrics

ChatGPT
List 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, get-business-metric-values, and get-business-metric-forecasted-values.

list-canvases

ChatGPT
List 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>

list-cost-alert-events

ChatGPT
List events for a Cost Alert. Events are individual alert trigger records and can be filtered by Cost Report token.

list-cost-alerts

ChatGPT
List all cost alerts available in the Vantage account. Cost alerts notify you when spending exceeds a specified threshold for a given cost report. Use the page value of 1 to start.

list-cost-integrations

ChatGPT
List 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/integrations Note 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')

list-cost-providers

ChatGPT
List 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-reports

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

list-cost-services

ChatGPT
List of cost services available to query for a given Workspace. Can be used to filter costs down to a specific service in VQL queries.

list-costs

ChatGPT
List 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 will let you get the information with fewer 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. Only use day/week if needed, otherwise DateBin=month is preferred, and month is the value set if you pass no value for DateBin.

list-dashboard-notifications

ChatGPT
Lists scheduled Dashboard emails. Start at page 1. Do not use this for Report Notifications, Cost Alerts, or Budget Alerts.

list-dashboards

ChatGPT
List 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>

list-financial-commitment-reports

ChatGPT
List all financial commitment reports available in the Vantage account. Use the page value of 1 to start.

list-folders

ChatGPT
List all Folders for organizing Cost Reports. Folders can be nested within other Folders via the parent_folder_token field. When you first call this function, use the "page" parameter of 1. The 'title' of a Folder describes its purpose. The 'saved_filter_tokens' field contains tokens of SavedFilters applied to Cost Reports within the Folder. The 'token' of a Folder can be used to generate a link in the Vantage Web UI: https://console.vantage.sh/go/<token>

list-kubernetes-efficiency-reports

ChatGPT
Lists saved Kubernetes Efficiency Reports.

list-network-flow-reports

ChatGPT
Lists saved Network Flow Reports. Use get-network-flow-report for a report's configuration.

list-provider-resources

ChatGPT
List 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. 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 Namespace - Tag-based filtering: - tags.name (tag key) - tags.value (tag content) VQL supports standard logical operators (AND, OR) and specialized functions: - 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') VQL Representation of Resource Types: | Provider | VQL Representation | Friendly Name | |---|---|---| | AWS | aws_auto_scaling_group | Auto Scaling Group | | AWS | aws_cloudtrail | CloudTrail | | AWS | aws_cloudwatch_log_group | CloudWatch Log Group | | AWS | aws_db_instance | RDS Instance | | AWS | aws_db_snapshot | RDS Snapshot | | AWS | aws_docdb_cluster_instance | DocumentDB Cluster Instance | | AWS | aws_dynamodb_table | DynamoDB Table | | AWS | aws_ebs_volume | EBS Volume | | AWS | aws_ec2_instance | EC2 Instance | | AWS | aws_ec2_managed_prefix_list | EC2 Managed Prefix List | | AWS | aws_ec2_reserved_instance | EC2 Reserved Instance | | AWS | aws_ecs_service | ECS Service | | AWS | aws_ecs_task_definition | ECS Task Definition | | AWS | aws_egress_only_internet_gateway | Egress-Only Internet Gateway | | AWS | aws_eip | Elastic IP | | AWS | aws_elasticache_cluster | ElastiCache Cluster | | AWS | aws_elasticsearch_domain | Elasticsearch Domain | | AWS | aws_flow_log | Flow Log | | AWS | aws_glacier_vault | Glacier Vault | | AWS | aws_instance_snapshot | EC2 Instance Snapshot | | AWS | aws_internet_gateway | Internet Gateway | | AWS | aws_kms_key | KMS Key | | AWS | aws_lambda_function | Lambda Function | | AWS | aws_lb | Load Balancer | | AWS | aws_nat_gateway | NAT Gateway | | AWS | aws_rds_reserved_instance | RDS Reserved Instance | | AWS | aws_redshift_cluster | Redshift Cluster | | AWS | aws_s3_bucket | S3 Bucket | | AWS | aws_savings_plan | Savings Plan | | AWS | aws_secretsmanager_secret | Secrets Manager Secret | | AWS | aws_vpc | VPC | | AWS | aws_vpc_endpoint | VPC Endpoint | | AWS | aws_vpn_gateway | VPN Gateway | Example VQL queries: - 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_ec2_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) Set include_cost to true to get cost breakdowns by category for each resource. Use the page parameter starting with 1 for pagination. Resources include metadata specific to their type (EC2 instances show instance type, EBS volumes show size, etc.). Each resource has a unique token that can be used to get more details or link to the Vantage Web UI.

list-recommendation-views

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

list-recommendations

ChatGPT
List 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 Each recommendation includes: - Potential cost savings amount - Description of what can be optimized - Provider and service information - Number of resources affected - Current status (open, resolved, dismissed) Recommendations can be filtered by status (open shows active recommendations, resolved shows implemented ones, dismissed shows ignored ones), cloud provider (aws, azure, gcp), specific workspace, provider account ID, and recommendation type. Prefer the type parameter when users ask for broad families (e.g. "AWS recommendations" -> type=aws; "EC2 rightsizing" -> type=aws:ec2:rightsizing). The type filter uses case-insensitive fuzzy matching on the recommendation type. The token of each recommendation can be used with other recommendation tools to get detailed information and see specific resources affected. For users to view and manage recommendations in the Vantage Web UI, they can visit https://console.vantage.sh/recommendations

list-report-forecasts

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

list-report-notifications

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

list-resource-report-columns

ChatGPT
List available columns for a resource type. The resource_type is a required parameter, and must be a valid VQL resource type name.

list-resource-reports

ChatGPT
List 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>

list-saved-filters

ChatGPT
List Saved Filters that can be applied to Cost Reports, optionally searching by title or Workspace.

list-scenario-models

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

list-tag-values

ChatGPT
Tags can have many values. Use this tool to find the values and service providers that are associated with a tag.

list-tags

ChatGPT
List 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. Link a user to the tag page like this: https://console.vantage.sh/settings/tags?search_query=<tag>

list-unit-costs

ChatGPT
Retrieve the unit costs for a given CostReport, with optional paging, date filters, and ordering.

list-virtual-tag-configs

ChatGPT
Lists 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-workspaces

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

query-costs

ChatGPT
Query 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>'). The service name must come from the list-cost-services tool. For the AWS provider, always use short names for the services. example: Use 'AmazonEC2' not 'Amazon Elastic Compute Cloud' and 'AmazonRDS' not 'Amazon Relational Database Service'. Again the list-cost-services tool in this MCP can give accurate service names. 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 will let you get the information with fewer 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. Only use day/week if needed, otherwise DateBin=month is preferred, and month is the value set if you pass no value for DateBin.

query-financial-commitment-report-costs

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

query-kubernetes-efficiency-report-costs

ChatGPT
Queries cost, idle cost, and cost-efficiency data for a Kubernetes Efficiency Report. Omit overrides to use the report's saved configuration. The accrued_at field is the start date of each aggregation bucket, not necessarily a date within the requested range. Weekly buckets follow calendar boundaries in the effective time zone, so querying September 1–7 can return bucket starts of August 31 and September 7.

query-network-flow-logs

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

remove-team-member

ChatGPT
Remove a user from a Team without deleting the user.

submit-user-feedback

ChatGPT
Submit 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 providing feedback.

update-access-policy

ChatGPT
Update an Access Policy's title, description, cost filter, or Team assignments. Requires account owner permissions; other callers receive 403 from the API.

update-annotation

ChatGPT
Update 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_token.

update-anomaly

ChatGPT
Updates 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-rule

ChatGPT
Updates 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

update-budget

ChatGPT
Updates an existing Budget. You can update the name, linked Cost Report, child Budget tokens for hierarchical budgets, or budget periods.

update-budget-alert

ChatGPT
Update an existing Budget Alert's monitored Budgets, percentage threshold, monthly time window, or recipients. Budget Alerts monitor Budget objects.

update-canvas

ChatGPT
Updates 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-alert

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

update-cost-report

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

update-dashboard

ChatGPT
Updates an existing Dashboard. You can update the title, widgets, saved filters, and date range settings.

update-dashboard-notification

ChatGPT
Updates a Dashboard Notification. Omitted fields stay unchanged. Setting dashboard_token points the email at that Dashboard and requires edit access to it. Do not use this for Report Notifications, Cost Alerts, or Budget Alerts.

update-dashboard-widget

ChatGPT
Updates one report-backed Dashboard Widget's linked resource, title, or display settings. Omitted fields stay unchanged. To change grid position or free-text content, send the full widget list to update-dashboard.

update-financial-commitment-report

ChatGPT
Updates 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. Unless date_interval is "custom", date_interval is incompatible with start_date and end_date. VQL filters use financial commitment fields and should follow Vantage Query Language syntax. Additional VQL documentation is available at https://docs.vantage.sh/vql.

update-folder

ChatGPT
Updates a Folder for organizing Cost Reports. You can update its title, move it to a different parent Folder, or change its SavedFilter tokens.

update-kubernetes-efficiency-report

ChatGPT
Updates a saved Kubernetes Efficiency Report. Omitted fields preserve the existing report configuration.

update-network-flow-report

ChatGPT
Updates a saved Network Flow Report. Use list-network-flow-reports to discover tokens.

update-recommendation-view

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

update-report-forecast

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

update-report-notification

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

update-resource-report

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

update-saved-filter

ChatGPT
Update a Saved Filter's title or VQL filter applied to Cost Reports.

update-scenario-model

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

update-team

ChatGPT
Update a Team's name, description, Workspace and user associations, user role, or default Dashboard.

update-virtual-tag-config

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

update-virtual-tag-config-value

ChatGPT
Partially 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-workspace

ChatGPT
Update an existing Workspace. You can update the name, currency conversion settings, currency code, and exchange rate date method.

Capabilities

Writes

Similar Apps