SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Vantage MCP with Hermes

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

Get started for freeGet a demo
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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Vantage account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Vantage MCP with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Vantage with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Vantage

Ask your agent to connect to Vantage, or simply request any Vantage-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Vantage connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Vantage or request any Vantage-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Vantage connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

FRAMEWORKS

How to build Vantage MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Vantage MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Vantage MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Vantage MCP with Atomic Agent

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