vantage-mcp-server

Self-hosted (local) MCP server that runs the same tools as the hosted Vantage MCP. Use this package when you need API-token auth without OAuth, or when you cannot reach the hosted endpoint.

Prefer the hosted MCP? Most clients can connect to https://mcp.vantage.sh/mcp with OAuth instead. See the repo README for those instructions.

Requirements

• Node.js 20+
• A Vantage API token

Set VANTAGE_TOKEN to your API token in the client config (examples below).

Claude Code

claude mcp add --transport stdio vantage --env VANTAGE_TOKEN=<your_vantage_api_token> -- npx -y vantage-mcp-server

Codex

codex mcp add vantage --env VANTAGE_TOKEN=<your_vantage_api_token> -- npx -y vantage-mcp-server

Cursor

Open Cursor Settings → Tools & MCP → New MCP Server (or create .cursor/mcp.json in your project):

{
  "mcpServers": {
    "Vantage": {
      "command": "npx",
      "args": ["-y", "vantage-mcp-server"],
      "env": {
        "VANTAGE_TOKEN": "<your_vantage_api_token>"
      }
    }
  }
}

Visual Studio Code

{
  "mcpServers": {
    "vantage": {
      "command": "npx",
      "args": ["-y", "vantage-mcp-server"],
      "env": {
        "VANTAGE_TOKEN": "<your_vantage_api_token>"
      }
    }
  }
}

Or use the command palette: MCP: Add Server → Command (stdio) and enter npx -y vantage-mcp-server, then set VANTAGE_TOKEN in the server env.

Windsurf

Under Cascade → MCP servers → Add custom server:

{
  "mcpServers": {
    "vantage": {
      "command": "npx",
      "args": ["-y", "vantage-mcp-server"],
      "env": {
        "VANTAGE_TOKEN": "<your_vantage_api_token>"
      }
    }
  }
}

Zed

In Zed settings:

{
  "context_servers": {
    "vantage": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "vantage-mcp-server"],
      "env": {
        "VANTAGE_TOKEN": "<your_vantage_api_token>"
      }
    }
  }
}

Goose

1. Extensions → Add custom extension
2. Type: STDIO
3. Command: npx
4. Args: -y vantage-mcp-server
5. Add environment variable VANTAGE_TOKEN with your API token

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "Vantage": {
      "command": "npx",
      "args": ["-y", "vantage-mcp-server"],
      "env": {
        "VANTAGE_TOKEN": "<your_vantage_api_token>"
      }
    }
  }
}

Restart Claude Desktop after saving.

Other clients

For any stdio MCP client:

• Command: npx
• Arguments: -y vantage-mcp-server
• Env: VANTAGE_TOKEN=<your_vantage_api_token>

See the MCP clients list and the Vantage MCP documentation for more clients and prompting examples.

Docs & source

• GitHub repository
• Vantage MCP docs