VantagePipe MCP Server

MCP server for VantagePipe — lets AI coding agents send trading signals, read position state, and monitor broker connections through natural language.

Quick start

VANTAGE_API_KEY=vp_live_... npx @vantagestack/mcp-server

Setup

1. Get an API key

Log in to VantagePipe → Settings → API Keys → Create key. Copy the full vp_live_... key.

2. Add to Claude Code

In your project, add to .claude/settings.local.json:

{
  "mcpServers": {
    "vantage": {
      "command": "npx",
      "args": ["-y", "@vantagestack/mcp-server"],
      "env": {
        "VANTAGE_API_KEY": "vp_live_your_key_here"
      }
    }
  }
}

3. Add to Claude Desktop

In ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vantage": {
      "command": "npx",
      "args": ["-y", "@vantagestack/mcp-server"],
      "env": {
        "VANTAGE_API_KEY": "vp_live_your_key_here"
      }
    }
  }
}

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | VANTAGE_API_KEY | Yes | — | Your VantagePipe API key (vp_{env}_{id}_{secret}) | | VANTAGE_API_ORIGIN | No | https://app.vantage-stack.com | Override for local development |

Available tools

| Tool | Description | |---|---| | ping_vantage | Check connectivity and API key validity | | get_canary_config | Admin-only. Read the canary_config singleton (enabled, period, skipClosedHours). |

More tools arriving in AGNT-02 (signal actions) and AGNT-03 (read + inspection).

Development

npm install
npm run build
npm test