vantage

The Vantage MCP Server exposes tools that let compatible MCP clients interact with your Vantage cloud cost data. In self-hosted local mode, it runs locally and communicates directly with MCP clients via stdio. This mode requires a Vantage API token and is ideal for individual developers who want full control over their environment. Clients like Claude, Cursor, and Goose can discover and invoke the server’s tools to list, query, or create Vantage resources such as costs, usage, and tags. To use it, configure your MCP client to launch the server (as illustrated in the README), provide your Vantage API token through the environment variable VANTAGE_TOKEN, and select the Vantage toolset from the client’s MCP tools list. When you prompt the server, it will execute the corresponding tool and return structured results compatible with the MCP protocol.

Prerequisites:

• Node.js v18+ and npm installed
• A Vantage account with at least one connected provider
• Access to an MCP-compatible client (Claude, Cursor, Goose, etc.)

Installation steps:

1. Clone the repository 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 per the Vantage docs and keep it handy to configure clients.
3. Start the server in self-hosted (local) mode by running the appropriate command in your environment (e.g., using npx as shown in this project’s examples or via your MCP client configuration).
4. If you plan to use the HTTP/Cloudflare Worker mode, follow the project’s guidance for setting up Wrangler and local development, including any env vars such as VANTAGE_TOKEN and VANTAGE_MCP_TOKEN when bypassing OAuth for local development.

Tips and common issues:

• In local development, set VANTAGE_TOKEN for direct access or VANTAGE_MCP_TOKEN to bypass OAuth during HTTP mode testing. This helps when your MCP client cannot pass OAuth headers.
• When using Claude or Cursor, ensure you replace placeholders in your client configuration with the actual path to your cloned repository and your Vantage API token.
• If you encounter transport or tool discovery issues, verify that your MCP client is pointed to the correct server and that the local server process has access to the Vantage API.
• For production deployments in HTTP mode, review Cloudflare Worker limits and authentication methods supported by Vantage.
• The README indicates a set of tools under src/tools; you can add new tools by creating TypeScript files under src/tools and following the registered tool pattern in the codebase.