For AI Agents
MCP Tools (8)
Complete reference for all 8 tools exposed by the VAEA MCP server. 6 are read-only (Eyes), 2 build transactions (Hands).
vaea_get_capacity👁️ Eyes
Get available flash loan liquidity across all protocols.
| Parameter | Type | Description |
|---|---|---|
| token | string (optional) | Filter by symbol. Omit for all tokens. |
Returns: Available amount, USD value, fee schedule, source protocol, and status per token.
{"token": "SOL"} → 245,000 SOL available, $36.7M USD, 2.1 bps total
vaea_get_quote👁️ Eyes
Get a fee quote for a specific borrow.
| Parameter | Type | Description |
|---|---|---|
| token | string | Token symbol (SOL, USDC, mSOL...) |
| amount | number | Amount to borrow |
Returns: Protocol fee, VAEA fee, total cost in bps, route type.
{"token": "SOL", "amount": 1000} → 2.1 bps total, Marginfi, direct route
vaea_find_best_route👁️ Eyes
Find the optimal protocol and route for a flash loan.
| Parameter | Type | Description |
|---|---|---|
| token | string | Token symbol |
| amount | number | Amount to borrow |
Returns: Best protocol, confidence score, fee breakdown, alternatives evaluated.
{"token": "SOL", "amount": 1000} → Marginfi (0.95 confidence), 5 routes evaluated
vaea_check_profitability👁️ Eyes
Check if a flash loan strategy is profitable after all costs.
| Parameter | Type | Description |
|---|---|---|
| token | string | Token symbol |
| amount | number | Amount |
| expected_revenue | number | Expected profit |
| gas_estimate | number (opt) | Gas in SOL |
Returns: Net profit, recommendation (send/wait/abort), cost breakdown.
{"token": "SOL", "amount": 1000, "expected_revenue": 0.5} → net: 0.29 SOL, send
vaea_get_protocol_status👁️ Eyes
Check health of lending protocols.
Returns: Status (active/paused/degraded), token count per protocol.
→ Marginfi: active (143 banks), Kamino: active (51 reserves), JupLend: active (39)
vaea_get_liquidity_matrix👁️ Eyes
Full liquidity breakdown per token per protocol.
| Parameter | Type | Description |
|---|---|---|
| token | string (optional) | Filter by symbol |
Returns: Amount available per protocol for each token.
{"token": "SOL"} → Marginfi: 120K, Kamino: 85K, JupLend: 40K
vaea_build_flash_loan🤲 Hands
Build an unsigned flash loan transaction.
| Parameter | Type | Description |
|---|---|---|
| token | string | Token symbol |
| amount | number | Amount |
| user_pubkey | string | Wallet address |
Returns: Serialized transaction (base64), protocol used, fee, _agent_hint for logic insertion.
{"token": "SOL", "amount": 1000, "user_pubkey": "..."} → base64 TX
vaea_build_sandwich🤲 Hands
Build a multi-token sandwich transaction.
| Parameter | Type | Description |
|---|---|---|
| tokens | array | [{token, amount}] |
| user_pubkey | string | Wallet address |
Returns: Serialized nested sandwich TX, with _agent_hint for each layer.
{"tokens": [{"token":"SOL","amount":1000},{"token":"USDC","amount":50000}]}
ℹ️ Note
Both the TypeScript and Rust MCP servers expose the exact same 8 tools with identical names, parameters, and response formats.