For AI Agents

MCP Server

For interactive AI assistants like Claude Desktop, Cursor, or Windsurf. The MCP server exposes all VAEA tools via the Model Context Protocol standard.

ℹ️ Note

MCP is for human-in-the-loop agents (chat assistants). For autonomous agents, use the Agent Kit or GOAT plugins instead — they're more direct and don't require an MCP client.

Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "vaea-flash": {
      "command": "npx",
      "args": ["-y", "@vaea/mcp-server"],
      "env": { "VAEA_API_URL": "https://api.vaea.fi" }
    }
  }
}

Cursor / Windsurf

json

{
  "mcpServers": {
    "vaea-flash": {
      "command": "npx",
      "args": ["-y", "@vaea/mcp-server"]
    }
  }
}

MCP Tools

The MCP server exposes 8 tools — the 5 core tools shared with all plugins, plus 3 bonus tools:

Tool	Type	Description
vaea_check_capacity	Core	Available liquidity per token
vaea_get_quote	Core	Fee breakdown for a borrow
vaea_find_best_route	Core	Best protocol + comparison
vaea_check_profitability	Core	Profit/loss after all costs
vaea_build_flash_loan	Core	Build unsigned TX
vaea_get_protocol_status	MCP only	Health of each lending protocol
vaea_get_liquidity_matrix	MCP only	Token × Protocol capacity grid
vaea_build_sandwich	MCP only	Build multi-token flash loan TX

MCP Resources (6)

Live data exposed as MCP resources for context injection:

URI	Description
vaea://liquidity	Real-time token liquidity across all protocols
vaea://fees	Current fee configuration and per-protocol rates
vaea://protocols	Lending protocol list, status, and health
vaea://matrix	Full liquidity matrix (token × protocol)
vaea://stats	API usage stats and uptime
vaea://discovery	Token discovery summary

MCP Prompts (3)

Pre-built strategy prompts for common use cases:

Prompt	What It Does
flash_arbitrage	Guides the agent through a full arbitrage flow: discover → route → build
flash_liquidation	Walks through borrowing to liquidate an undercollateralized position
flash_collateral_swap	Steps the agent through a collateral swap without closing the position

Rust Server

For lower memory and faster startup, use the native Rust binary (~4 MB, starts in milliseconds):

bash

cd mcp/rust && cargo build --release
# Binary: target/release/vaea-mcp

json

{
  "mcpServers": {
    "vaea-flash": {
      "command": "/path/to/vaea-mcp",
      "env": { "VAEA_API_URL": "https://api.vaea.fi" }
    }
  }
}