vantage-mcp-server
The Vantage MCP Server is an open-source tool, written in Golang, that lets you interact with your cloud cost data through AI assistants and MCP clients. By acting as a bridge to Vantage s existing APIs, the Vantage MCP Server lets you query cloud spend data using natural language and makes cost analysis more intuitive.
? Note: At this time, the Vantage MCP Server is available only as a locally run service using Standard Input/Output (stdio) Transport, meaning it must be executed on your machine or server and integrated with an MCP client.
The Vantage MCP Server currently exposes the following tools, which can be invoked by any compatible MCP client (e.g., Claude, Cursor, Goose):
query-costsA general purpose way to fetch Cost data using VQL.
list-costs
Display all the Costs in an associated Cost Report.
list-cost-reports
List all Cost Reports available.
get-cost-report-forecast
List all Forecasts of spending related to a Cost Report.
list-cost-integrations
List all Cost Provider integrations (e.g., AWS, Azure, GCP) available to provide Costs data from and their associated accounts.
list-cost-providers
List of just the Providers that the given Workspace has shared with it.
list-cost-services
Lists all the Services and their associated Provider that is shared with the given Workspace.
list-budgets
List all Budgets available to compare against a Cost Report and track spending.
list-dashboards
List all Dashboards created in the Vantage account.
list-tags
List Tags that can be used to filter Cost Reports.
list-tag-values
List Tag values that can be used to filter Cost Reports.
list-anomalies
List Anomalies that were detected on Cost Reports.
list-cost-providers
List Cost Providers that can be used to filter Costs in VQL queries.
list-unit-costs
Retrieve the Unit Costs for a given Cost Report.
get-myself
A utility to list available Workspaces and check the access level of your auth token.
submit-user-feedback
If you re installing from source, ensure the following packages are installed (see .tool-versions for exact versions):
You can use a version manager (e.g., asdf) or package manager (e.g., Homebrew) to install these dependencies.
You will also need to create a Read-Only Vantage API token (Write will not work at this time). Follow the instructions on the Vantage API documentation. We recommend creating a brand-new read-only API token for exclusive use with the MCP Server.
brew install vantage-sh/tap/vantage-mcp-servergit clone https://github.com/vantage-sh/vantage-mcp-servergo build -o vantage-mcp-server
chmod +x vantage-mcp-server? Note: If you pull down new changes from the repository, be sure to re-run
go buildto rebuild the server and ensure you re running the latest version.
npx @modelcontextprotocol/inspector -e VANTAGE_BEARER_TOKEN=<token> ./vantage-mcp-serverSetup instructions vary depending on which MCP client you use. Example clients include:
See the MCP documentation for a list of available clients. Detailed instructions for Claude for Desktop, Cursor, and Goose are provided below.
Command + ,).Click Edit Config. A configuration file is created at:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%Claudeclaude_desktop_config.json
Open the claude_desktop_config.json file and update its contents. Make sure to replace the placeholders <path_to_compiled_vantage_mcp_server_binary> with the path where you downloaded the Vantage MCP Server binary, and <personal_vantage_api_token> with your Vantage API token.
{
"mcpServers": {
"Vantage": {
"command": "<path_to_compiled_vantage_mcp_server_binary>",
"args": [],
"env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
}
}
}mcp.json file. Make sure to replace the placeholders <path_to_compiled_vantage_mcp_server_binary> with the path where you downloaded the Vantage MCP Server binary, and <personal_vantage_api_token> with your Vantage API token.{
"mcpServers": {
"Vantage": {
"command": "<path_to_compiled_vantage_mcp_server_binary>",
"args": [],
"env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
}
}
}Command + ,).vantage-mcp-server.Vantage.Query costs and usage data.VANTAGE_BEARER_TOKEN and the value set to your Vantage API token.If you download a release from our Github page and the executable fails to run "because the developer cannot be verified", please open your System Settings. Then find the "Privacy and Security" section. Then scroll to the bottom and you should see a message that "vantage-mcp-server-macos" was blocked, click the "open anyway" button. After this flow, the executable should be able to be run without issue.
If you d like to contribute to this project:
git checkout -b feature/my-feature.We welcome community contributions, improvements, and bug fixes. If you run into any issues, submit a bug report via this repository s GitHub Issues.
See the LICENSE.MD file for commercial and non-commercial licensing details.