YieldCave MCP server

compare_yield_to_tokenized_treasuries

Given an APY the user currently earns (e.g. a bank savings rate), computes the simple-interest difference versus the highest-yielding liquid tokenized treasury over a horizon. Returns arithmetic and assumptions only; it does not recommend.

read-only

Argument	Type	Description
amountUsd	number	Amount in USD (default 10,000)
minTvlUsd	number	Liquidity floor for candidates (default 50,000,000)
horizonDays	integer	Horizon in days (default 365)
currentApyPercent*	number	APY the user earns today, in percent, e.g. 0.5

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "currentApyPercent"
  ],
  "properties": {
    "amountUsd": {
      "type": "number",
      "description": "Amount in USD (default 10,000)",
      "exclusiveMinimum": 0
    },
    "minTvlUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Liquidity floor for candidates (default 50,000,000)"
    },
    "horizonDays": {
      "type": "integer",
      "description": "Horizon in days (default 365)",
      "exclusiveMinimum": 0
    },
    "currentApyPercent": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "APY the user earns today, in percent, e.g. 0.5"
    }
  },
  "additionalProperties": false
}

create_alert

Creates a rule that is checked every hour after the data refresh. When any matching deployment crosses the threshold, YieldCave POSTs a JSON payload to your HTTPS webhook (Slack, Discord, Zapier, your own server). Fires at most once per 24 hours per rule. universe "rwa" (tokenized treasuries, default) or "stablecoin" (stablecoin pools with at least $10M TVL; omit symbol for all major stablecoins). Returns the alert id; keep it to delete the alert later.

Argument	Type	Description
chain	string	Restrict to one chain
label	string	Free text shown in the payload
metric*	string	"apy" in percent, "tvl" in USD
symbol	string	One token, e.g. "USDY". Omit for every tokenized treasury
operator*	string
universe	string	Default rwa
threshold*	number	e.g. 4.5 for APY, 500000000 for TVL
webhookUrl*	string	Where to POST when the alert fires

Input schema (JSON)

create_api_key

Creates a free YieldCave API key (300 calls/day, 3 alerts, 7 days of history) tied to an email address. The key is shown once. Send it on every request as an x-api-key header or Authorization: Bearer. One key per email.

Argument	Type	Description
email*	string	Where to reach you about the key

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Where to reach you about the key"
    }
  },
  "additionalProperties": false
}

delete_alert

Deletes an alert by id.

destructive

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

get_rwa_asset

Returns every deployment of one tokenized asset symbol (e.g. BUIDL, USDY, OUSG) across chains, with total TVL and curated description.

read-only

Argument	Type	Description
symbol*	string	Token symbol, e.g. "BUIDL"

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Token symbol, e.g. \"BUIDL\""
    }
  },
  "additionalProperties": false
}

get_tokenized_equity

All tokenized versions of one underlying stock (e.g. TSLA) across issuers: market caps, volumes, chains, the most liquid wrapper, and (on Pro) the premium/discount range versus the underlying quote.

read-only

Argument	Type	Description
underlying*	string	Underlying ticker, e.g. "NVDA"

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "underlying"
  ],
  "properties": {
    "underlying": {
      "type": "string",
      "minLength": 1,
      "description": "Underlying ticker, e.g. \"NVDA\""
    }
  },
  "additionalProperties": false
}

list_alerts

Lists active alert rules (webhook hosts only, never full URLs).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_rwa_yields

Lists tokenized real-world asset deployments (tokenized US treasuries, credit, funds) with current APY and TVL, from public DefiLlama data. Filter by chain or kind. Information only, not advice.

read-only

Argument	Type	Description
kind	string	"treasury" = tokenized US government debt / money-market style
chain	string	Blockchain name, e.g. "Ethereum", "Solana", "Base"
limit	integer	Max rows (default 20)
sortBy	string	Sort key (default tvlUsd)
minTvlUsd	number	Minimum total value locked in USD (default 1,000,000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "enum": [
        "treasury",
        "other_rwa"
      ],
      "type": "string",
      "description": "\"treasury\" = tokenized US government debt / money-market style"
    },
    "chain": {
      "type": "string",
      "description": "Blockchain name, e.g. \"Ethereum\", \"Solana\", \"Base\""
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max rows (default 20)"
    },
    "sortBy": {
      "enum": [
        "tvlUsd",
        "apy"
      ],
      "type": "string",
      "description": "Sort key (default tvlUsd)"
    },
    "minTvlUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum total value locked in USD (default 1,000,000)"
    }
  },
  "additionalProperties": false
}

list_stablecoin_yields

Where USDC, USDT, DAI, USDe and other stablecoins earn yield right now: single-asset pools on lending markets and vaults (credit and basis venues on Pro) (DefiLlama data, excludes tokenized treasuries, which have their own tools). Each row carries its protocol category group (lending, vault, credit, basis), base vs reward APY, 30-day mean APY and TVL. Default: pools with at least $10M TVL, highest APY first. Information only, not advice.

read-only

Argument	Type	Description
chain	string	Blockchain name, e.g. "Base"
group	string	Risk/category group
limit	integer	Max rows (default 20)
sortBy	string	Default apy
symbol	string	Stablecoin symbol, e.g. "USDC"
majorOnly	boolean	Only major stablecoins (USDC, USDT, DAI, USDS, USDe, PYUSD, ...)
minTvlUsd	number	Minimum pool TVL in USD (default 10,000,000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "chain": {
      "type": "string",
      "description": "Blockchain name, e.g. \"Base\""
    },
    "group": {
      "enum": [
        "lending",
        "vault",
        "credit",
        "basis",
        "other"
      ],
      "type": "string",
      "description": "Risk/category group"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max rows (default 20)"
    },
    "sortBy": {
      "enum": [
        "apy",
        "tvlUsd"
      ],
      "type": "string",
      "description": "Default apy"
    },
    "symbol": {
      "type": "string",
      "description": "Stablecoin symbol, e.g. \"USDC\""
    },
    "majorOnly": {
      "type": "boolean",
      "description": "Only major stablecoins (USDC, USDT, DAI, USDS, USDe, PYUSD, ...)"
    },
    "minTvlUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum pool TVL in USD (default 10,000,000)"
    }
  },
  "additionalProperties": false
}

list_tokenized_equities

Tokenized equities on public chains (xStocks, bStocks, Ondo Global Markets, Robinhood, Dinari, Coinbase and others): token price, market cap, 24h volume, the underlying ticker, chains, and (on Pro) premium or discount to the latest underlying quote. Filter by issuer, kind (stock, pre-ipo, etf), underlying or chain. Information only, not advice.

read-only

Argument	Type	Description
kind	string
chain	string	Chain name as CoinGecko lists it, e.g. "solana", "arbitrum-one", "ethereum"
limit	integer	Max rows (default 20; Free and anonymous up to 10, Pro up to 100)
issuer	string	Issuer name or part of it, e.g. "xStocks", "Ondo", "Robinhood"
sortBy	string	Default marketCap; premium sorts by absolute premium
underlying	string	Underlying ticker, e.g. "TSLA"
minMarketCapUsd	number	Default 1,000,000

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "enum": [
        "stock",
        "pre-ipo",
        "etf"
      ],
      "type": "string"
    },
    "chain": {
      "type": "string",
      "description": "Chain name as CoinGecko lists it, e.g. \"solana\", \"arbitrum-one\", \"ethereum\""
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max rows (default 20; Free and anonymous up to 10, Pro up to 100)"
    },
    "issuer": {
      "type": "string",
      "description": "Issuer name or part of it, e.g. \"xStocks\", \"Ondo\", \"Robinhood\""
    },
    "sortBy": {
      "enum": [
        "marketCap",
        "volume",
        "premium"
      ],
      "type": "string",
      "description": "Default marketCap; premium sorts by absolute premium"
    },
    "underlying": {
      "type": "string",
      "description": "Underlying ticker, e.g. \"TSLA\""
    },
    "minMarketCapUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Default 1,000,000"
    }
  },
  "additionalProperties": false
}

manage_subscription

Returns a Stripe Billing Portal link to update payment details, see invoices, or cancel the Pro subscription. Needs an API key with a subscription.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

my_usage

Shows the caller's plan, calls used today, remaining allowance, alert allowance, depth limits, and what each plan includes.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

rwa_changes

Compares the latest market with the snapshot from N days ago (default 1): APY and TVL change per deployment, biggest movers first, plus new and vanished deployments. universe "rwa" (default) or "stablecoin".

read-only

Argument	Type	Description
days	integer	How many days back to compare against (default 1)
kind	string	Default "treasury" (rwa universe only)
limit	integer	Max movers (default 15)
universe	string	Default rwa

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "How many days back to compare against (default 1)"
    },
    "kind": {
      "enum": [
        "treasury",
        "other_rwa"
      ],
      "type": "string",
      "description": "Default \"treasury\" (rwa universe only)"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max movers (default 15)"
    },
    "universe": {
      "enum": [
        "rwa",
        "stablecoin"
      ],
      "type": "string",
      "description": "Default rwa"
    }
  },
  "additionalProperties": false
}

rwa_history

Daily snapshots of total TVL and TVL-weighted APY for one symbol, optionally on one chain, over the last N days (default 30; Free and anonymous plans see 7, Pro the full history). universe "rwa" (tokenized assets, default) or "stablecoin" (stablecoin pools). Includes the change from first to last day.

read-only

Argument	Type	Description
days	integer	How many days back (default 30)
chain	string	Restrict to one chain
symbol*	string	Symbol, e.g. "USDY" or "USDC"
universe	string	Default rwa

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "How many days back (default 30)"
    },
    "chain": {
      "type": "string",
      "description": "Restrict to one chain"
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Symbol, e.g. \"USDY\" or \"USDC\""
    },
    "universe": {
      "enum": [
        "rwa",
        "stablecoin"
      ],
      "type": "string",
      "description": "Default rwa"
    }
  },
  "additionalProperties": false
}

rwa_issuer_terms

Hand-curated terms for a tokenized treasury token: who may invest (US persons?), minimum, structure (summary on Free; Pro adds what backs it, domicile, redemption method and timing, fees, yield mechanics and source URLs). Covers BUIDL, USYC, USDY, OUSG, USTB, TBILL, STBT, BENJI. Null means not stated by the source.

read-only

Argument	Type	Description
symbol*	string	Token symbol, e.g. "USYC"

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Token symbol, e.g. \"USYC\""
    }
  },
  "additionalProperties": false
}

rwa_market_summary

Totals for the tokenized treasury market: distinct tokens, total TVL, median APY, top tokens by TVL, plus totals for other tokenized real-world assets.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

stablecoin_yield_summary

Per stablecoin: venues, total TVL, median APY, best venue overall and best collateralized-lending venue; totals by category group; and the median tokenized treasury APY for comparison. Pools with at least $10M TVL by default.

read-only

Argument	Type	Description
minTvlUsd	number	Pool TVL floor (default 10,000,000)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "minTvlUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Pool TVL floor (default 10,000,000)"
    }
  },
  "additionalProperties": false
}

tokenized_equity_summary

Totals for tokenized equities: token count, market cap and 24h volume; breakdown by issuer and by kind; top underlyings by combined market cap (top 5 on Free, 10 on Pro); on Pro, how many tokens have an underlying quote and the median absolute premium.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

upgrade

Returns a checkout link for the Pro plan ($49/month: full history and changes, all stablecoin venues, full issuer terms, 100 alerts, 5000 calls/day). Needs an API key.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

YieldCave

Try it

compare_yield_to_tokenized_treasuries

YieldCave

Try it

compare_yield_to_tokenized_treasuries

Tools (19)