YieldCave

Official19 tools

by yieldcave · JavaScript

Tokenized asset data for agents: treasury yields, stablecoin rates, tokenized stocks, alerts.

com.yieldcave/yieldcave — MCP Server

The com.yieldcave/yieldcave MCP server provides tokenized asset data for agents, covering treasury yields, stablecoin rates, tokenized stocks, and alerts. The description identifies its focus as “Tokenized asset data” that agents can consume as structured information.

🛠️ Key Features

Tokenized asset data for agents
Treasury yields
Stablecoin rates
Tokenized stocks
Alerts

🚀 Use Cases

Supplying agents with treasury yield information
Providing stablecoin rate data to agent workflows
Supporting agent access to tokenized stock data
Triggering or supplying alert-related information

⚡ Developer Benefits

Clear data categories: yields, stablecoin rates, tokenized stocks, and alerts
Designed for agent consumption of tokenized asset data

⚠️ Limitations

No tool count, topics, or additional readme details were provided in the available server data

Topics

ai-agentsclaudedefimcpmodel-context-protocolrwatokenized-treasuries

Captured live from the server via tools/list.

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.

Parameters5

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

Raw schema

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

get_rwa_asset

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

Parameters1

symbol

string

required

Token symbol, e.g. "BUIDL"

Raw schema

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

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.

Parameters

No parameters.

Raw schema

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

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.

Parameters4

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

Raw schema

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

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.

Parameters7

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

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Stablecoin symbol, e.g. \"USDC\""
    },
    "chain": {
      "type": "string",
      "description": "Blockchain name, e.g. \"Base\""
    },
    "group": {
      "type": "string",
      "enum": [
        "lending",
        "vault",
        "credit",
        "basis",
        "other"
      ],
      "description": "Risk/category group"
    },
    "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)"
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "apy",
        "tvlUsd"
      ],
      "description": "Default apy"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max rows (default 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

minTvlUsd

number

optional

Pool TVL floor (default 10,000,000)

Raw schema

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

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, premium or discount to the latest underlying quote where available, and chains. Filter by issuer, kind (stock, pre-ipo, etf), underlying or chain. Information only, not advice.

Parameters7

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

Raw schema

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

get_tokenized_equity

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

Parameters1

underlying

string

required

Underlying ticker, e.g. "NVDA"

Raw schema

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

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; how many tokens have an underlying quote and the median absolute premium.

Parameters

No parameters.

Raw schema

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

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.

Parameters1

symbol

string

required

Token symbol, e.g. "USYC"

Raw schema

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

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.

Parameters4

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

Raw schema

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

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".

Parameters4

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

Raw schema

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

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.

Parameters8

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

Raw schema

{
  "type": "object",
  "properties": {
    "universe": {
      "type": "string",
      "enum": [
        "rwa",
        "stablecoin"
      ],
      "description": "Default rwa"
    },
    "metric": {
      "type": "string",
      "enum": [
        "apy",
        "tvl"
      ],
      "description": "\"apy\" in percent, \"tvl\" in USD"
    },
    "operator": {
      "type": "string",
      "enum": [
        "above",
        "below"
      ]
    },
    "threshold": {
      "type": "number",
      "description": "e.g. 4.5 for APY, 500000000 for TVL"
    },
    "webhookUrl": {
      "type": "string",
      "format": "uri",
      "pattern": "^https\\:\\/\\/",
      "description": "Where to POST when the alert fires"
    },
    "symbol": {
      "type": "string",
      "description": "One token, e.g. \"USDY\". Omit for every tokenized treasury"
    },
    "chain": {
      "type": "string",
      "description": "Restrict to one chain"
    },
    "label": {
      "type": "string",
      "maxLength": 80,
      "description": "Free text shown in the payload"
    }
  },
  "required": [
    "metric",
    "operator",
    "threshold",
    "webhookUrl"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_alerts

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

Parameters

No parameters.

Raw schema

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

delete_alert

Deletes an alert by id.

Parameters1

string

required

Raw schema

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

create_api_key

Creates a free YieldCave API key (1000 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.

Parameters1

string

required

Where to reach you about the key

Raw schema

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

my_usage

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

Parameters

No parameters.

Raw schema

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

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.

Parameters

No parameters.

Raw schema

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

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.

Parameters

No parameters.

Raw schema

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

README.md12 KBView on GitHub

YieldCave

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:

"What tokenized US treasuries are on Solana right now, and what do they yield?"
"How much more would $25k earn in the best liquid tokenized treasury than in my 0.4% savings account?"
"Summarize the tokenized RWA market."
"Where does USDC earn the most on a collateralized lending market with at least $50M behind it?"
"Which tokenized NVIDIA token is the most liquid, and is it trading at a premium to the stock?"

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.

1. Run it locally (5 minutes)

You need Node 20 or newer (node --version).

bash

cd ~/yieldcave && npm install

See the data in your terminal:

bash

npm run demo

Run the unit tests (no network needed):

bash

npm test

Run the end-to-end checks, which start the real MCP server and call it the way Claude would, over stdio and over HTTP:

bash

npm run smoke && npm run smoke:http

2. Add it to Claude Desktop

Open this file (create it if it does not exist):

code

~/Library/Application Support/Claude/claude_desktop_config.json

Add YieldCave under mcpServers. If the file already has other servers, add just the "yieldcave" block inside the existing object.

json

{
  "mcpServers": {
    "yieldcave": {
      "command": "node",
      "args": ["/Users/bjf/yieldcave/src/server.js"]
    }
  }
}

Quit and reopen Claude Desktop. You should see a tools icon with four YieldCave tools. Try: "Use YieldCave to summarize the tokenized treasury market."

3. Add it to Claude Code

bash

claude mcp add yieldcave -- node /Users/bjf/yieldcave/src/server.js

3b. Use it from claude.ai in a browser (hosted version)

YieldCave also runs in the cloud on Supabase, so claude.ai (and anyone else) can reach it without your Mac being on.

code

https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp

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:

code

supabase/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 Postgres
supabase/functions/refresh/   fetches DefiLlama + CoinGecko + quotes, writes market_latest + today's snapshot, fires alerts; needs REFRESH_SECRET header
supabase/functions/enrich/    fills chain metadata for tokenized equities, 15 per run, every 10 minutes
supabase/functions/stripe-webhook/  upgrades/downgrades keys on Stripe events
supabase/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 bucket
scripts/                      configure-stripe.sh, publish-site.sh

To redeploy after a change:

bash

supabase functions deploy mcp --no-verify-jwt --use-api && supabase functions deploy refresh --no-verify-jwt --use-api

Check a deployment end to end (tools, history, and an alert that creates, fires, and deletes itself):

bash

set -a; source .env.local; set +a; YIELDCAVE_URL=https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp npm run smoke:remote && npm run smoke:alerts

Secrets (database password, refresh secret) live in .env.local, which git ignores. Never commit them.

4. The tools

Tool	What it returns
`list_rwa_yields`	Tokenized RWA deployments with APY and TVL. Filter by `chain`, `kind` (`treasury` or `other_rwa`), `minTvlUsd`; sort by `tvlUsd` or `apy`
`get_rwa_asset`	One symbol (e.g. `BUIDL`) across every chain, with total TVL and a curated description
`list_stablecoin_yields`	Single-asset stablecoin pools (USDC, USDT, DAI, USDe, ...) on lending, vault, credit and basis venues, each labelled by group, with base vs reward APY, 30-day mean and TVL. $10M floor by default
`stablecoin_yield_summary`	Per stablecoin: venues, TVL, median APY, best venue overall and best collateralized-lending venue; totals by group; tokenized-treasury median for comparison
`list_tokenized_equities`	Tokenized stocks, pre-IPO shares and ETFs (xStocks, bStocks, Ondo, Robinhood, Dinari, Coinbase, ...): price, market cap, volume, underlying ticker, premium/discount to the underlying quote, chains. Source: CoinGecko, quotes via Yahoo chart data
`get_tokenized_equity`	One underlying (e.g. TSLA) across every wrapper: issuers, chains, most liquid token, premium range
`tokenized_equity_summary`	Totals, by issuer and kind, top underlyings, premium statistics
`rwa_market_summary`	Totals: distinct treasury tokens, TVL, median APY, top five, plus other RWA totals
`compare_yield_to_tokenized_treasuries`	Simple-interest arithmetic: your current APY vs the best liquid tokenized treasury over a horizon, with assumptions spelled out
`rwa_issuer_terms`	Hand-curated terms for BUIDL, USYC, USDY, OUSG, USTB, TBILL, STBT, BENJI: structure, eligibility (US persons?), minimums, redemption, fees, sources, date verified
`rwa_history`	Daily TVL and TVL-weighted APY for one symbol over the last N days, with the change. `universe` is `rwa` or `stablecoin`. Hosted: from Postgres snapshots. Local: from `npm run snapshot` files
`rwa_changes`	What moved since N days ago: APY and TVL change per deployment, new and vanished deployments (hosted, or local with snapshots)
`create_alert`, `list_alerts`, `delete_alert`	Hosted only, needs a key. A rule such as "any treasury APY above 4.5" or "USDY TVL below $1B". Checked hourly; fires a JSON POST to your HTTPS webhook (Slack, Discord, Zapier, your server) at most once per 24 hours
`create_api_key`, `my_usage`, `upgrade`, `manage_subscription`	Hosted only. Free key by email (shown once), plan and usage, a Pro checkout link, and a Stripe billing-portal link to change or cancel

4b. Plans, keys and metering (hosted)

Plan	Price	Calls/day	Alerts	History	Changes	Stablecoin venues	Issuer terms	Tokenized equities
Anonymous	$0	100 per IP	0	7 days	1 day back	lending and vault, 10 rows	summary	10 rows, no premiums
Free key	$0	300	3	7 days	1 day back	lending and vault, 10 rows	summary	10 rows, no premiums
Pro	$49/month	5,000	100	full	any range	all groups, 100 rows	full record with sources	100 rows, premiums and premium sort

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://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp?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:

bash

./scripts/configure-stripe.sh sk_live_... price_... whsec_...

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.

5. Project layout

code

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 tools
src/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 tools
src/snapshot.js saves today's market locally (npm run snapshot)
src/server.js   stdio entry point: Claude Desktop, Claude Code, Cursor
src/http.js     HTTP entry point: claude.ai custom connectors, remote clients
src/demo.js     prints a summary table in the terminal
test/           unit tests (node --test) and a live smoke test
site/           landing page with a live table (npm run site, then open http://localhost:8080)

6. How it works, for someone new to APIs

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.

7. Next steps

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).

Disclaimer

Information only, not financial advice. Figures come from public third-party data and may be delayed or wrong. Verify with the issuer before acting.

License

MIT

Install

Tools (19)

list_rwa_yieldsget_rwa_assetrwa_market_summarycompare_yield_to_tokenized_treasurieslist_stablecoin_yieldsstablecoin_yield_summarylist_tokenized_equitiesget_tokenized_equity

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "yieldcave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.yieldcave/yieldcave — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_rwa_yields

get_rwa_asset

rwa_market_summary

compare_yield_to_tokenized_treasuries

list_stablecoin_yields

stablecoin_yield_summary

list_tokenized_equities

get_tokenized_equity

tokenized_equity_summary

rwa_issuer_terms

rwa_history

rwa_changes

create_alert

list_alerts

delete_alert

create_api_key

my_usage

upgrade

manage_subscription

YieldCave

1. Run it locally (5 minutes)

2. Add it to Claude Desktop

3. Add it to Claude Code

3b. Use it from claude.ai in a browser (hosted version)

4. The tools

4b. Plans, keys and metering (hosted)

5. Project layout

6. How it works, for someone new to APIs

7. Next steps

Disclaimer

License

Install

Remote endpoint

Related servers