Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt

Use this file to discover all available pages before exploring further.

The Vaults.fyi MCP server connects MCP-compatible clients to the full Vaults.fyi data and transaction surface. Discovery, history, recommendations, position tracking, and transaction building are all callable as tools — your client decides which to use and how to chain them. Hosted at https://mcp.vaults.fyi/mcp over streamable HTTP. 38 tools. Bearer-token auth. No server-side private keys: every transaction tool returns calldata for your client to sign.

​
What people use it for

A few prompts that exercise meaningful tool chains:
“Find me the best USDC yields right now with TVL over $10M and no active warnings.”
“What yields beat the USDC benchmark by more than 200 bps over the last 30 days?”
“Show me Steakhouse and Gauntlet curated Morpho vaults across all stablecoins.”
“Which Aave v3 markets have the highest USDC supply APY across networks?”
“I’d consider sUSDe and sUSDS — find vaults with composite APY above 8% accounting for the underlying asset rate.”
“Plot Fluid USD Vault APY against the USDC benchmark for the last 90 days.”
“Audit positions for 0xabc… — total deposited, current value, unclaimed rewards, and any flagged exposure.”
“Build a deposit of 10,000 USDC into the highest-rated Morpho vault on Base and return the calldata.”

​
Quickstart

You’ll need a Vaults.fyi API key. Request one at portal.vaults.fyi.
Add the server to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
claude_desktop_config.json
{
  "mcpServers": {
    "vaults-fyi": {
      "url": "https://mcp.vaults.fyi/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VAULTS_API_KEY"
      }
    }
  }
}
Restart Claude Desktop. The 38 Vaults.fyi tools will appear in the tools menu.

​
What you can do

Six capability surfaces, each backed by several tools:

Discover and filter

Search across networks, protocols, assets, curators, and tags. Filter by TVL, APY, score, and active warnings in a single structured query.

Evaluate risk

Reputation Scores and inline flags (bad debt exposure, qualified-investor gates, depegs, recent incidents) ship with the data. No separate lookup.

Analyze history

APY, TVL, share-price, and total-return time series for any vault. Asset-price history and benchmark APY for relative performance.

Build and execute transactions

Deposit, withdraw, claim rewards, and approve. Tools return decoded calldata and signing instructions; your client signs and submits.

Track portfolios

Aggregate positions and rewards across networks for any address. Drill into per-position cost basis and event history.

Operate on tokens

Approve, transfer, wrap, and unwrap as primitives — useful when an agent is composing multi-step flows.

​
Tool inventory

38 tools, grouped by purpose. Each returns structured JSON optimized for agent consumption.
ToolPurpose
vaults_searchFiltered search across vaults (TVL, APY, score, curator, tags, warnings)
vaults_listPaginated full vault list
networksSupported chains
protocolsSupported protocols
assetsSupported assets
curatorsNamed curators (79+)
tagsVault tags (e.g., top-curator, lst, rwa)
ToolPurpose
vault_detailsFull vault metadata, including flags and Reputation Score
vault_apyCurrent APY (headline, base, rewards, composite)
vault_tvlCurrent TVL
ToolPurpose
vault_apy_historyAPY time series
vault_tvl_historyTVL time series
vault_share_price_historyShare-price time series
vault_historyCombined APY/TVL/share-price
vault_returnsRealized total returns
asset_price_historyUnderlying asset price
benchmark_apyAsset-level benchmark APY
benchmark_apy_historyBenchmark APY time series
ToolPurpose
best_vaultSingle best-fit vault for a given asset/criteria
best_deposit_optionsRanked deposit options
ToolPurpose
positionsAll positions for an address
position_detailsPer-position cost basis, current value, P&L
wallet_balancesToken balances across networks
token_balanceSingle token balance
user_eventsDeposit/withdraw/claim history
rewardsOutstanding reward entitlements
ToolPurpose
transaction_contextPre-flight context (allowance, balances, gas)
build_vault_txDeposit/withdraw calldata with decoded steps
build_claim_rewardsClaim calldata for a single vault
claim_all_rewardsMulti-vault claim calldata
withdraw_all_positionsMulti-vault withdraw calldata
submit_tx_hashRegister a submitted hash for status tracking
get_transaction_statusStatus of a tracked transaction
ToolPurpose
approve_erc20ERC-20 approval calldata
transfer_erc20ERC-20 transfer calldata
transfer_nativeNative transfer calldata
wrap_nativeWrap native to wrapped equivalent
unwrap_nativeUnwrap

​
Authentication

Every request requires a bearer token: 
Authorization: Bearer YOUR_VAULTS_API_KEY
The API key is forwarded only to Vaults.fyi API calls and is never placed in signing URLs or transaction payloads.
Request a key at portal.vaults.fyi. For keyless pay-per-request access via USDC on Base, see x402.

​
Signing model

Transaction tools (build_vault_tx, build_claim_rewards, approve_erc20, etc.) return structured calldata, not signed transactions. The server holds no private keys. Each response includes:
  • stepDecodings — human-readable description of each call
  • signingInstructions — step-by-step guidance for the signer
  • signingPaths — supported signing surfaces (e.g., wallet, OWS)
  • submitTool — the tool to call after signing (submit_tx_hash)
  • statusTool — the tool to call for status (get_transaction_status)
This keeps key custody with the client. Agents that integrate with OpenWallet Standard can sign and submit without leaving the conversation.

​
Going further

AI agents overview

The full surface area for agents: MCP, x402, and the LLM-optimized API reference.

Keyless access via x402

Pay-per-request access on Base, no API key required.

LLM-optimized API reference

Full reference at llms.txt and llms-full.txt.

OpenAPI spec

Underlying REST API the MCP wraps.