Vantage Cloud Cost Management MCP server

The Vantage MCP Server enables natural language interaction with your organization's cloud cost data through AI assistants and MCP clients. You can ask questions about cloud spend, cost tagging, provider integrations, and more using tools like Claude, Cursor, and Goose.

Installation Options

Prerequisites

Before installation, you'll need:

• A Read-Only Vantage API token (get one from the Vantage API documentation)

If installing from source, ensure you have:

• Go
• Node.js

Installing with Homebrew

The simplest installation method on macOS is using Homebrew:

brew install vantage-sh/tap/vantage-mcp-server

Installing from Source

1. Clone the repository:

git clone https://github.com/vantage-sh/vantage-mcp-server

2. Build the server:

go build -o vantage-mcp-server
chmod +x vantage-mcp-server

3. Test the server with the MCP inspector:

npx @modelcontextprotocol/inspector -e VANTAGE_BEARER_TOKEN=<token> ./vantage-mcp-server

MacOS Security Note

If you download a release from the GitHub page and see a message that "the developer cannot be verified":

1. Open System Settings
2. Go to "Privacy and Security"
3. Scroll to the message about "vantage-mcp-server-macos" being blocked
4. Click "Open Anyway"

Setting Up MCP Clients

Claude for Desktop

1. Download Claude for Desktop
2. Open Settings via Claude > Settings (or Command + ,)
3. Select Developer in the left menu
4. Click Edit Config
5. Update the config file with:

{
  "mcpServers": {
    "Vantage": {
      "command": "<path_to_compiled_vantage_mcp_server_binary>",
      "args": [],
      "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
    }
  }
}

6. Save and restart Claude
7. Click the hammer icon in the bottom-right corner to access the tools

Cursor

1. Download Cursor
2. Open Cursor > Settings > Cursor Settings
3. Select MCP in the left pane
4. Click Add new global MCP Server
5. Update the mcp.json file with:

{
  "mcpServers": {
    "Vantage": {
      "command": "<path_to_compiled_vantage_mcp_server_binary>",
      "args": [],
      "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
    }
  }
}

Goose

1. Download Goose
2. Open Goose > Settings (or Command + ,)
3. Under Extensions, click Add custom extension
4. Fill in the fields:
   • ID: vantage-mcp-server
   • Name: Vantage
   • Description: Query costs and usage data
   • Command: Path to the Vantage MCP Server binary
   • Environment Variables: Add VANTAGE_BEARER_TOKEN with your API token
5. Click Add

Available Tools

The Vantage MCP Server provides several tools you can use through MCP clients:

• query-costs: Fetch cost data using VQL
• list-costs: Display all costs in a cost report
• list-cost-reports: List all available cost reports
• get-cost-report-forecast: Get spending forecasts for a cost report
• list-cost-integrations: List all provider integrations (AWS, Azure, GCP, etc.)
• list-cost-providers: List providers shared with your workspace
• list-cost-services: List all services and their associated providers
• list-budgets: List all available budgets
• list-dashboards: List all created dashboards
• list-tags: List tags for filtering cost reports
• list-tag-values: List tag values for filtering cost reports
• list-anomalies: List detected anomalies on cost reports
• list-unit-costs: Get unit costs for a cost report
• get-myself: List available workspaces and check token access level
• submit-user-feedback: Send feedback to the Vantage team

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "Vantage" '{"command":"<path_to_compiled_vantage_mcp_server_binary>","args":[],"env":{"VANTAGE_BEARER_TOKEN":"<personal_vantage_api_token>"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "Vantage": {
            "command": "<path_to_compiled_vantage_mcp_server_binary>",
            "args": [],
            "env": {
                "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "Vantage": {
            "command": "<path_to_compiled_vantage_mcp_server_binary>",
            "args": [],
            "env": {
                "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect