How to integrate Vantage MCP with Atomic Agent

Connect Atomic Agent to Vantage MCP. Analyze last month's cloud spend breakdown, list active budgets and recent alerts, and more using natural language, with authentication handled for you.

Vantage MCP logoVantage MCP
Dcr Oauth

Vantage MCP is a FinOps platform for analyzing cloud costs, budgets, resources, and tags. It helps teams detect anomalies, optimize spend, and manage budgets more effectively.

127 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Vantage.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Vantage account. See the Atomic Agent documentation for installation instructions.

Also integrate Vantage MCP with

How Atomic Agent connects to Vantage

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Vantage to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Vantage. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Vantage account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Vantage MCP server, and what's possible with it?

The Vantage MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Vantage account. It provides structured and secure access so your agent can perform Vantage operations on your behalf.

Use Vantage from Atomic Agent

With your account connected, ask Atomic Agent to work with Vantage in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Vantage MCP action and event your agent gets out of the box.

Create-annotation

Create an Annotation on one or more Cost Reports for a specific date.

Create-billing-rule

Creates a new Billing Rule.

Create-budget

Creates a budget based on the parameters specified.

Create-budget-alert

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

Creates a Canvas based on the parameters specified.

Create-cost-alert

Create a new Cost Alert in Vantage.

Create-cost-report

Create a new Cost Report in Vantage.

Create-dashboard

Create a new Dashboard in Vantage.

Create-financial-commitment-report

Create a new Financial Commitment Report in Vantage.

Create-folder

Create a folder for organizing Cost Reports or Resource Reports.

Create-network-flow-report

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

Create-recommendation-view

Create a new Recommendation View in Vantage.

Create-report-forecast

Create a scenario-model ReportForecast for a Cost Report.

Create-report-notification

Create a new Report Notification in Vantage.

Create-resource-report

Create a saved Resource Report in Vantage.

Create-scenario-model

Create a ScenarioModel with optional periods and provider/service filters.

Create-virtual-tag-config

Creates a new Virtual Tag (Virtual Tag Config) in Vantage.

Create-virtual-tag-config-value

Adds a new mapping/value to an existing Virtual Tag Config without replacing its other values.

Create-workspace

Create a new Workspace in Vantage.

Delete-annotation

Delete an Annotation by its token.

Delete-billing-rule

Deletes a Billing Rule by its token.

Delete-budget

Deletes a Budget by its token.

Delete-budget-alert

Delete a Budget Alert by token.

Delete-canvas

Deletes a Canvas by its token.

Delete-cost-alert

Deletes a Cost Alert by its token.

Delete-cost-report

Deletes a cost report by its token.

Delete-dashboard

Deletes a Dashboard by its token.

Delete-financial-commitment-report

Deletes a financial commitment report by its token.

Delete-folder

Deletes a Folder.

Delete-network-flow-report

Deletes a Network Flow Report by token.

Delete-recommendation-view

Deletes a recommendation view by its token.

Delete-report-forecast

Delete a scenario-model ReportForecast by token.

Delete-report-notification

Deletes a Report Notification by its token.

Delete-resource-report

Deletes a resource report by its token.

Delete-scenario-model

Delete a ScenarioModel by token.

Delete-virtual-tag-config

Deletes an entire Virtual Tag Config and all of its mappings/values.

Delete-virtual-tag-config-value

Deletes exactly one mapping/value from an existing Virtual Tag Config, not the containing tag.

Get-anomaly

Gets a specific anomaly alert by its token.

Get-billing-rule

Gets a specific Billing Rule by its token.

Get-budget

Gets a specific Budget by its token.

Get-budget-alert

Get a specific Budget Alert by token.

Get-business-metric

Get a specific BusinessMetric by token.

Get-business-metric-forecasted-values

Get forecasted values for a BusinessMetric.

Get-business-metric-values

Get historical values for a BusinessMetric.

Get-canvas

Gets a specific Canvas by its token.

Get-cost-alert

Gets a specific Cost Alert by its token.

Get-cost-alert-event

Gets a specific Cost Alert event by its token.

Get-cost-provider-accounts

Get Cost Provider Accounts in a workspace with human-readable titles.

Get-cost-report

Gets a specific cost report by its token.

Get-cost-report-forecast

Given a Cost Report Token, Vantage can forecast the costs for a given time range.

Get-dashboard

Gets a specific dashboard by its token.

Get-financial-commitment-report

Gets a specific financial commitment report by its token.

Get-folder

Gets a specific Folder by its token.

Get-myself

Get data that is available to the current auth token.

Get-network-flow-report

Gets a saved Network Flow Report by token.

Get-provider-resource

Get detailed information about a specific provider resource using its token or UUID.

Get-recommendation-details

Get comprehensive details about a specific cost optimization recommendation using its unique token.

Get-recommendation-resource-details

Get comprehensive details about a specific infrastructure resource within a cost optimization recommendation, including the exact actions recommended for that resource.

Get-recommendation-resources

Get a paginated list of all infrastructure resources affected by a specific cost optimization recommendation.

Get-recommendation-view

Gets a specific recommendation view by its token.

Get-report-forecast

Get a specific scenario-model ReportForecast by token.

Get-report-notification

Gets a specific Report Notification by its token.

Get-resource-report

Gets a specific resource report by its token.

Get-scenario-model

Get a specific ScenarioModel by token.

Get-team

Gets a specific team with its token.

Get-teams

Return all Teams that the user has access to.

Get-user

Gets a specific User by their token.

Get-users

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

Get-virtual-tag-config

Returns one existing Virtual Tag (Virtual Tag Config) with its complete ordered mappings/values.

Get-virtual-tag-config-value

Returns one mapping/value from an existing Virtual Tag Config, including its filter and allocation settings.

Get-workspace

Gets a specific Workspace by its token.

List-annotations

List report annotations available to the authenticated Vantage access token, ordered from newest to oldest.

List-anomalies

Given a token of a Cost Report, look for anomalies in the report.

List-audit-logs

List audit logs visible to the authenticated Vantage access token.

List-billing-rules

List all billing rules available in the Vantage account.

List-budget-alerts

List Budget Alerts in Vantage.

List-budgets

List all budgets available in the Vantage account.

List-business-metric-labels

List distinct label values for a BusinessMetric.

List-business-metrics

List all BusinessMetrics available to the current Vantage API token.

List-canvases

List all saved Canvases available in the Vantage account.

List-cost-alert-events

List events for a Cost Alert.

List-cost-alerts

List Cost Alerts available in the Vantage account.

List-cost-integrations

List all cost provider integrations available to provide costs data from and their associated accounts.

List-cost-providers

List of cost providers available to query for a given Workspace.

List-cost-reports

List all cost reports available.

List-costs

List the cost items inside a report.

List-cost-services

List cost service display names for a workspace.

List-dashboards

List all dashboards available in the Vantage account.

List-financial-commitment-reports

List all financial commitment reports available in the Vantage account.

List-folders

List folders for Cost Reports or Resource Reports, optionally filtering by title, Workspace, or folder type.

List-network-flow-reports

Lists saved Network Flow Reports.

List-provider-resources

List infrastructure provider resources (instances, volumes, load balancers, etc.

List-recommendations

List all cost optimization recommendations available in the Vantage account.

List-recommendation-views

List all recommendation views available in the Vantage account.

List-report-forecasts

List scenario-model ReportForecasts for a Cost Report.

List-report-notifications

List Report Notifications available in the Vantage account.

List-resource-report-columns

List available columns for a resource type.

List-resource-reports

List all resource reports available.

List-scenario-models

List ScenarioModels available to the current Vantage API token.

List-tags

List tags that can be used to filter costs and cost reports.

List-tag-values

List values for a tag key.

List-unit-costs

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

List-virtual-tag-configs

Lists or searches the Virtual Tags (Virtual Tag Configs) the current API token can access, including every mapping/value.

List-workspaces

List all Workspaces available to the authenticated API token.

Query-costs

Query for costs in a Vantage Account.

Query-network-flow-logs

Queries aggregated network flow log data (costs and bytes).

Submit-user-feedback

Submit feedback on using the Vantage MCP Server.

Update-annotation

Update the title, date, message, or associated Cost Reports of an existing Annotation.

Update-anomaly

Updates an existing anomaly alert by its token.

Update-billing-rule

Updates an existing Billing Rule.

Update-budget

Updates an existing Budget.

Update-budget-alert

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

Update-canvas

Updates an existing Canvas.

Update-cost-alert

Updates an existing Cost Alert.

Update-cost-report

Updates an existing Cost Report.

Update-dashboard

Updates an existing Dashboard.

Update-financial-commitment-report

Updates an existing Financial Commitment Report.

Update-folder

Updates a Folder's title, parent, or SavedFilter tokens.

Update-network-flow-report

Updates a saved Network Flow Report.

Update-recommendation-view

Updates an existing Recommendation View.

Update-report-forecast

Update a scenario-model ReportForecast.

Update-report-notification

Updates an existing Report Notification in Vantage.

Update-resource-report

Updates an existing Resource Report.

Update-scenario-model

Update an existing ScenarioModel.

Update-virtual-tag-config

Updates an existing Virtual Tag's config-level settings or complete ordered mappings/values.

Update-virtual-tag-config-value

Partially edits one mapping/value in an existing Virtual Tag Config.

Update-workspace

Update an existing Workspace.

FAQ

Frequently asked questions

With a standalone Vantage MCP server, the agents and LLMs can only access a fixed set of Vantage tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Vantage and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Vantage tools.

Yes, absolutely. You can configure which Vantage scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Vantage data and credentials are handled as safely as possible.

Start with Vantage MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Vantage MCP tool your agent needs.Free to start.

Start building