MCP Tools
14 MCP tools for vault search, risk scores, vault comparison, market lookups, loop venue checks, and incident history.
search_vaults
Search and filter DeFi vaults by chain, protocol, asset, risk tier, and TVL.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Search by vault name, symbol, asset, protocol, or curator |
| chain | string | No | Filter by chain name or slug (e.g., Ethereum, Base, Solana) |
| protocol | string | No | Protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino |
| protocolVersion | string | No | Generation: v3, v4, v3-lido, v3-horizon, klend, kvault. Use with protocol=aave to isolate V4 |
| asset | string | No | Filter by asset symbol (e.g., USDC, WETH) |
| riskTier | string | No | Filter by risk tier: Prime, Core, or Edge |
| minTvl | number | No | Minimum TVL in USD |
| depositable | boolean | No | Filter by current deposit capacity. true excludes vaults whose maxDeposit == 0 on-chain. |
| sortBy | string | No | Sort field: tvl_usd, apr_net, name, last_synced_at |
| sortOrder | string | No | Sort order: asc or desc |
| limit | number | No | Max results (default 10, max 50) |
Each result also surfaces a Deposits: line: closed when is_depositable === false, open · capacity $… when there is a known remaining cap, open · no cap observed when the headroom is not published (uncapped, unpriced or unread — pre-flight before sizing), or unknown when on-chain status has not yet been probed.
Example prompts:
- "Find all Prime-tier USDC vaults on Ethereum above my minimum TVL threshold"
- "Find the highest-APY USDC vaults that are actually accepting deposits right now"
- "Search Aave V4 WETH vaults" (agent should send
protocol=aave,protocolVersion=v4,asset=WETH) - "Show Maple pools on Ethereum"
IDs and longer workflows: Examples.
get_vault
Get full vault details including risk breakdown, snapshots, and events.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | No | Vault ID (e.g., morpho-1-0x...) |
| network | string | No | Registry network slug (e.g., ethereum, base, solana) |
| address | string | No | Vault address: 0x-hex on EVM chains, base58 (case-sensitive) on Solana |
Requires either id OR both network and address.
Example prompt: "Show me the details for the Gauntlet USDC vault on Ethereum"
get_vault_risk_breakdown
Detailed risk vector analysis showing Asset, Platform and Strategy, Control and Governance, and History scores.
| Parameter | Type | Required | Description |
|---|---|---|---|
| network | string | Yes | Registry network slug (e.g., ethereum, solana) |
| address | string | Yes | Vault address: 0x-hex on EVM chains, base58 on Solana |
Example prompt: "Break down the risk vectors for vault 0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458 on Ethereum"
compare_vaults
Side-by-side comparison of 2-3 vaults across risk, yield, and other dimensions.
| Parameter | Type | Required | Description |
|---|---|---|---|
| vaults | array | Yes | Array of vault objects, each with network and address (min 2, max 3) |
Example prompt: "Compare the Gauntlet USDC and Steakhouse USDC vaults on Morpho"
find_safest_vaults
Find the top 10 safest audited vaults, optionally filtered by asset or chain.
| Parameter | Type | Required | Description |
|---|---|---|---|
| asset | string | No | Filter by asset symbol (e.g., USDC, WETH) |
| chain | string | No | Filter by chain name |
| minTvl | number | No | Minimum TVL in USD |
Example prompt: "What are the safest WETH vaults?"
get_protocol_info
Get protocol details including security history, audit info, and versions.
| Parameter | Type | Required | Description |
|---|---|---|---|
| protocolId | string | Yes | Protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino. V4 is a version under aave. |
Example prompts:
- "Tell me about Morpho's security history"
- "How many Aave V4 vaults are there, and on which versions is Aave listed?"
get_curator_info
Get curator details and track record.
| Parameter | Type | Required | Description |
|---|---|---|---|
| curatorId | string | Yes | Curator ID |
Example prompt: "What's Gauntlet's track record as a vault curator?"
get_market_overview
Get platform-wide DeFi vault statistics. No parameters required.
Example prompt: "Give me an overview of the DeFi vault market"
list_markets
List lending markets (Aave spokes, composed V4 hub parents, Morpho markets, and Kamino K-Lend markets) with supplied/borrowed rollups.
| Parameter | Type | Required | Description |
|---|---|---|---|
| protocol | string | No | Protocol id: aave, spark, compound, morpho, kamino |
| version | string | No | Protocol version: v3, v4, klend. Use version=v4 with protocol=aave. |
| chain | number or string | No | Chain: integer id (1, 8453) or slug (ethereum, solana) |
| limit | number | No | Results per page (1-100, default 20) |
| sortBy | string | No | total_supplied_usd, total_borrowed_usd, reserve_count, name |
Example prompts:
- "List the largest Aave V4 markets by supplied value"
- "Open the Aave V4 Global Dollar hub and its spokes"
- "List Aave V3 markets on Ethereum"
- "List Kamino K-Lend markets on Solana by supplied value"
- "List Morpho Blue markets on Base"
Vaults use protocolVersion. This tool uses version. Both mean the generation.
get_market
Get one market's detail: reserves, rates, hub linkage, and metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
| marketId | string | Yes | Market id from list_markets |
Example prompts:
- "Show every reserve in Aave V4 Ethereum Main" (
marketId=aave-v4-1-main) - "Open the Aave V4 Global Dollar hub" (
marketId=aave-v4-1-hub-global-dollar) - "Open Aave V4 EtherFi Cash on Optimism" (
marketId=aave-v4-10-etherfi-cash)
check_loop_venue
Underwrite a collateral/debt pair on one lending market. Returns score, tier, utilization, borrow APR, deposit status, and recent incidents for both legs. Does not compute health factor and does not prepare transactions.
| Parameter | Type | Required | Description |
|---|---|---|---|
| marketId | string | Yes | Market id from list_markets. Spoke example: aave-v4-1-main |
| collateral | string | Yes | Collateral asset symbol you will post (e.g. weETH, WETH, cbBTC) |
| debt | string | Yes | Debt asset symbol you will borrow (e.g. USDC, USDT, GHO) |
If you do not have a market id, call list_markets first (Aave V4: protocol=aave, version=v4).
Example prompt: "Check looping weETH against USDC on Aave V4 Ethereum Main"
get_market_events
Recent events for one market.
| Parameter | Type | Required | Description |
|---|---|---|---|
| marketId | string | Yes | Market id from list_markets |
| limit | number | No | 1-100, default 20 |
Example prompt: "What happened recently in that market?"
explain_risk_score
Explain what a risk score means and its tier classification.
| Parameter | Type | Required | Description |
|---|---|---|---|
| score | number | Yes | Risk score (0-10) to explain |
Example prompt: "What does a risk score of 7.3 mean?"
list_vaults_with_incidents
List vaults with critical incidents in the last 365 days, sorted by TVL. No parameters required.
Example prompt: "Which vaults have had security incidents recently?"