· Channels — how you connect

MCP Server

AlgoVault's Model Context Protocol server exposes every trade-call, market-regime, and cross-venue scan tool to AI agents over one endpoint. Point Claude, Cursor, Cline, or any MCP client at https://api.algovault.com/mcp — the free tier needs no API key. Streamable HTTP or stdio transport, with typed tool schemas out of the box.

When to use MCP Server vs the other channels

Reach for MCP when your agent framework speaks the Model Context Protocol — Claude Desktop, Cursor, Cline, or an MCP-aware LangChain / LlamaIndex stack. It gives typed tool discovery and the full tool set. If you just want raw HTTP without an MCP client, use the REST API; if you want AlgoVault to push to you, use Webhooks.

Connect

{
  "mcpServers": {
    "algovault": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.algovault.com/mcp?src=docs",
               "--header", "Authorization: Bearer ${AV_API_KEY}",
               "--header", "X-AlgoVault-Track-Token:chan-docs"]
    }
  }
}

Full reference in the docs →

AV_KEY="av_live_..."   # paste your API key

# 1. initialize — captures session-id from response headers
SESSION_ID=$(curl -sS -i -X POST https://api.algovault.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AV_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}' \
  | awk 'BEGIN{IGNORECASE=1} /^mcp-session-id:/ {gsub(/\r/,""); print $2; exit}')

# 2. notify "initialized" (required by MCP protocol)
curl -sS -X POST https://api.algovault.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AV_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}' >/dev/null

# 3. now call tools/call
curl -sS -X POST https://api.algovault.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AV_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_trade_call","arguments":{"coin":"SOL","timeframe":"5m","exchange":"BINANCE"}},"id":2}'

Full reference in the docs →

Tool coverage

Every publicly-listed tool reachable through MCP Server (equities are held from public listings):

Frequently asked questions

Do I need an API key to use the MCP server?

No — the free tier is keyless. Point your MCP client at https://api.algovault.com/mcp and start calling tools. An API key raises your limits but is not required to connect.

What transports does the MCP server support?

Streamable HTTP is the default remote transport; stdio is available for local process integration (set TRANSPORT=stdio). Both expose the same tool set.

Which MCP clients work with AlgoVault?

Any MCP-compliant client — Claude Desktop, Cursor, Cline, and MCP-aware agent frameworks. See the Integrations page for per-client setup recipes.

How is MCP different from the REST API?

MCP gives typed tool discovery and schemas over a protocol; the REST API is plain HTTP request/response. Use MCP when your framework speaks it, and the REST API when it does not.

Explore the tools →