Vantage MCP Server

Use natural language to explore your organization's cloud costs via MCP clients, like Claude, Cursor, and others. Ask questions about your organization's previous and current cloud cost spend, cost tagging, provider integrations, and more.

About the Vantage MCP Server

This repository supports two different deployment modes for the Vantage MCP Server:

• Self-Hosted (Local) Mode: via src/local.ts

  • Runs locally using Standard Input/Output (stdio) Transport
  • Direct communication with MCP clients
  • Requires a Vantage API token
  • Best for individual users, development, or when you want full control

• Remote (HTTP) Mode: via src/cf-worker.ts

  • Runs as a Cloudflare Worker with HTTP endpoints
  • Supports multiple authentication methods (OAuth, API tokens, Vantage headers)
  • Accessible via web requests
  • Best for teams, production deployments, or when you need web-based access

  📝 Note: For using the remote HTTP version in a non-development workflow, see the Vantage MCP documentation.

Available Tools

The Vantage MCP Server exposes a set of tools for listing, querying, and creating Vantage resources. These tools can be invoked by any compatible MCP client and are available in /src/tools.

Get Started

Prerequisites

• Node.js (v18 or higher) and npm installed
• Access to an MCP-compatible client (such as Claude Desktop, Cursor, or Goose)
• A Vantage account with at least one connected provider (AWS, Azure, Google Cloud, etc.)

Installation

1. Clone this repo and install dependencies:

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

2. Create a Vantage API token following the Vantage documentation.

Run the MCP Server: Self-Hosted (Local) Mode

📝 Note: This self-hosted mode is intended for developing and contributing to the MCP server. For personal use, the recommended approach is to use npx -y vantage-mcp-server.

To use the self-hosted MCP server, you'll need to configure your MCP client to launch the server. The configuration process varies depending on which MCP client you use. Example clients include:

• Claude for Desktop
• Cursor
• Goose

See the MCP documentation for a list of available clients. Detailed instructions for Claude for Desktop, Cursor, and Goose are provided below.

Claude for Desktop

1. Download Claude for Desktop.
2. From the top of Claude for Desktop, click Claude > Settings (keyboard shortcut Command + ,).
3. In the left menu of the Settings pane, select Developer.
4. Click Edit Config. A configuration file is created at:

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

5. Open the claude_desktop_config.json file and update its contents. Replace the placeholders <path_to_repository> with the path where you cloned this repository, and <personal_vantage_api_token> with your Vantage API token.

   {
     "mcpServers": {
       "Vantage": {
         "command": "npx",
         "args": ["tsx", "<path_to_repository>/src/local.ts"],
         "env": { "VANTAGE_TOKEN": "<personal_vantage_api_token>" }
       }
     }
   }
   

   📝 _Note: The server u

... View full README on GitHub