com.yieldcavePublished by yieldcave.comOfficial publisherv0.9.1Updated Oct 30, 2026
Tokenized asset data for agents: treasury yields, stablecoin rates, tokenized stocks, alerts.
Read-only tokenized-finance data server: tokenized treasury and stablecoin yields, tokenized equities, history, and webhook alerts.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.yieldcave%2Fyieldcave/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"yieldcave": {
"type": "http",
"url": "https://mcp.yieldcave.com/"
}
}
}Machine-readable tokenized-finance data for AI agents: tokenized treasuries, stablecoin yield venues, and tokenized stocks.
YieldCave is an MCP server. Add it to Claude Desktop, Claude Code or Cursor and your agent can answer questions like:
It is read-only. It never touches a wallet, never moves money and never recommends. That is the point: an index, not a broker.
Data comes from DefiLlama's public API. No API key is needed.
You need Node 20 or newer (node --version).
See the data in your terminal:
Run the unit tests (no network needed):
Run the end-to-end checks, which start the real MCP server and call it the way Claude would, over stdio and over HTTP:
Open this file (create it if it does not exist):
Add YieldCave under mcpServers. If the file already has other servers, add just the "yieldcave" block inside the existing object.
Quit and reopen Claude Desktop. You should see a tools icon with four YieldCave tools. Try: "Use YieldCave to summarize the tokenized treasury market."
YieldCave also runs in the cloud on Supabase, so claude.ai (and anyone else) can reach it without your Mac being on.
In claude.ai: Customize → Connectors → Add → Add custom connector → paste that URL, no sign-in. The hosted version serves data from Postgres, which a scheduled job refreshes every hour, and it keeps one snapshot per day. That history powers the fifth tool, rwa_history.
How the hosted version is put together, all inside the supabase/ folder:
To redeploy after a change:
Check a deployment end to end (tools, history, and an alert that creates, fires, and deletes itself):
Secrets (database password, refresh secret) live in .env.local, which git ignores. Never commit them.
Live data is free; depth is paid. Get a key by asking your agent to call create_api_key with your email; send it as an x-api-key header (or Authorization: Bearer), or as ?key=yc_... on the connector URL for claude.ai. Pro is bought with the upgrade tool (Stripe checkout) and managed with manage_subscription. Self-hosted servers have no plan limits.
claude.ai setup with a key. Custom connectors in claude.ai cannot send request headers, so the key goes in the URL: add a custom connector with https://mcp.yieldcave.com/?key=yc_your_key and "No sign-in". A header (x-api-key or Authorization: Bearer) wins when both are present. The server never logs query strings or keys. Treat the URL as a secret, since anyone holding it holds the key.
Every tools/call is counted in the usage_daily table against the key, or a hashed IP for anonymous callers. Limits reset at midnight UTC. Keys are stored as SHA-256 hashes; the plain key is returned once and never again. Alerts belong to the key that created them. All of this is in supabase/functions/mcp/index.ts; the limits themselves are in supabase/functions/_shared/plans.js.
Switching on payments needs a Stripe account and three values. Create a recurring $49/month product, add a webhook endpoint for https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/stripe-webhook with the events checkout.session.completed, customer.subscription.deleted, customer.subscription.updated, then run:
Until then, upgrade returns a polite "payments are not switched on yet". The webhook upgrades a key to Pro when checkout completes and downgrades it when the subscription ends; manage_subscription opens Stripe's billing portal (return URL https://yieldcave.com). Checkout success and cancel pages are https://yieldcave.com/thanks and https://yieldcave.com; a SITE_URL secret overrides both if you ever need to.
Landing page is https://yieldcave.com, hosted on Cloudflare (Workers static assets, the current form of Cloudflare Pages). Edit site/*.html, then publish with ./scripts/publish-site.sh, which runs wrangler pages deploy (one-time npx wrangler login first). The site Edge Function is a fallback copy of the same pages and is not linked from anywhere.
Every response carries a disclaimer and the time the data was fetched. Issuer terms are curated by hand in supabase/functions/_shared/issuers.js with a verifiedOn date and source URLs; update that file when terms change.
An API is a URL that returns data instead of a web page. Open https://yields.llama.fi/pools in a browser and you will see raw JSON for ~16,000 yield pools. src/data.js downloads that, keeps only the pools DefiLlama classifies as real-world assets, and reshapes each one into a dozen clearly named fields.
MCP is a small protocol that lets an AI model call functions you define. src/server.js tells the model "here are four functions, here is what each argument means"; when the model decides to call one, the server runs the matching function in src/tools.js and hands back JSON. Claude reads that JSON and writes the answer in English.
The server talks over stdio (standard input/output), which is why console.log is banned inside it: anything printed to stdout would corrupt the protocol stream. Use console.error for debugging.
Hosted endpoint, history, issuer terms, webhook alerts, API keys and metering are live. Pro needs only a Stripe account to switch on. Next: a custom domain, and more asset classes (tokenized equities).
Information only, not financial advice. Figures come from public third-party data and may be delayed or wrong. Verify with the issuer before acting.
MIT
Source: README.md at commit e787231
List tokenized real-world asset 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.
kindchainlimitsortByminTvlUsdGet one tokenized asset across chains
Returns every deployment of one tokenized asset symbol (e.g. BUIDL, USDY, OUSG) across chains, with total TVL and curated description.
symbolrequiredTokenized 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.
Takes no parameters.
Compare a 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.
amountUsdminTvlUsdhorizonDayscurrentApyPercentrequiredStablecoin yields by venue
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.
chaingrouplimitsortBysymbolmajorOnlyminTvlUsdStablecoin yield market 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.
minTvlUsdTokenized stocks, pre-IPO shares and ETFs
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.
kindchainlimitissuersortByunderlyingminMarketCapUsdOne stock across every tokenized wrapper
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.
underlyingrequiredTokenized equity market 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.
Takes no parameters.
Issuer terms for a tokenized treasury
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.
symbolrequiredDaily history for one tokenized asset
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.
dayschainsymbolrequireduniverseWhat changed in the tokenized RWA market
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".
dayskindlimituniverseCreate a webhook 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.
chainlabelmetricrequiredsymboloperatorrequireduniversethresholdrequiredwebhookUrlrequiredList alerts
Lists active alert rules (webhook hosts only, never full URLs).
Takes no parameters.
Delete an alert
Deletes an alert by id.
idrequiredCreate a free 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.
emailrequiredMy plan and usage
Shows the caller's plan, calls used today, remaining allowance, alert allowance, depth limits, and what each plan includes.
Takes no parameters.
Upgrade to Pro
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.
Takes no parameters.
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.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
cd ~/yieldcave && npm installnpm run demonpm testnpm run smoke && npm run smoke:http~/Library/Application Support/Claude/claude_desktop_config.json{ "mcpServers": { "yieldcave": { "command": "node", "args": ["/Users/bjf/yieldcave/src/server.js"] } }}claude mcp add yieldcave -- node /Users/bjf/yieldcave/src/server.jshttps://mcp.yieldcave.comsupabase/functions/_shared/ the real code: data.js, tools.js, mcp.js (src/ re-exports these)supabase/functions/mcp/ public MCP endpoint, reads market_latest and snapshots from Postgressupabase/functions/refresh/ fetches DefiLlama + CoinGecko + quotes, writes market_latest + today's snapshot, fires alerts; needs REFRESH_SECRET headersupabase/functions/enrich/ fills chain metadata for tokenized equities, 15 per run, every 10 minutessupabase/functions/stripe-webhook/ upgrades/downgrades keys on Stripe eventssupabase/functions/site/ serves the landing page (pages.js is generated from site/)supabase/migrations/ tables (market, snapshots, alerts, api_keys, usage_daily), RLS on, hourly pg_cron job, public site bucketscripts/ configure-stripe.sh, publish-site.shsupabase functions deploy mcp --no-verify-jwt --use-api && supabase functions deploy refresh --no-verify-jwt --use-apiset -a; source .env.local; set +a; YIELDCAVE_URL=https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp npm run smoke:remote && npm run smoke:alerts./scripts/configure-stripe.sh sk_live_... price_... whsec_...src/data.js re-export of supabase/functions/_shared/data.js (fetch, normalize, cache, local snapshots, equities)src/equities.js re-export of _shared/equities.js: tokenized stock parsing and toolssrc/tools.js re-export of _shared/tools.js: pure functions behind each tool (unit-tested)src/mcp.js re-export of _shared/mcp.js: declares the five toolssrc/snapshot.js saves today's market locally (npm run snapshot)src/server.js stdio entry point: Claude Desktop, Claude Code, Cursorsrc/http.js HTTP entry point: claude.ai custom connectors, remote clientssrc/demo.js prints a summary table in the terminaltest/ unit tests (node --test) and a live smoke testsite/ landing page with a live table (npm run site, then open http://localhost:8080)