BitcoinYield
Best live crypto yield at each A-D risk grade on BTC, ETH, SOL and stablecoins, DeFi and CeFi.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"yields": {
"url": "https://bitcoinyield.co/api/mcp"
}
}
}Remote endpoints
https://bitcoinyield.co/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢list_yields(asset, stablecoin, max_risk, all)
One entry per asset (Bitcoin, ETH, SOL, USDC, USDT and every other tracked stablecoin, tokenized Treasury and L1) with its best current yield across DeFi and CeFi under BitcoinYield's risk-weighted ranking, its A-D risk grade, and a link to the full comparison. by_grade gives the best proven rate at grade A, B and C (A = lower risk), the tradeoff a holder chooses between: a grade is null when nothing proven at it pays materially more (at least 0.05 points and 5%) than a safer grade. best_apy and each by_grade rate are in percent (0.17 means 0.17%), as the asset page shows them (today's rate, or its 7-day average when that is lower); quote best_rate_text and each by_grade rate_text, which print them with their unit, APY or APR. To answer 'what is the best yield on X', quote by_grade, the lowest-risk grade first: best_apy is the by_grade step the risk-weighted ranking puts first and can be a higher-risk one, or one closed to US residents. An asset with no proven offer has no pick: best_apy is null and no_pick_reason says why its top-ranked offer is not one. Set max_risk to limit every pick to offers graded at or below that letter. Rates are variable and not advice. No key required. With no asset or stablecoin filter this tool answers the headline assets (BTC, ETH, SOL, USDC, USDT, DAI, USDe, USD1, USDG, PYUSD, RLUSD); set all to true for every asset with a live yield.
Input Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string",
"description": "Filter to one asset by its symbol, e.g. BTC, USDC or USDE. For a token an asset is held as, give the asset: BTC for WBTC, ETH for stETH, DAI for USDS or sUSDS, SOL for jitoSOL (the tokens themselves are also read as their asset).",
"enum": [
"BTC",
"ETH",
"SOL",
"USDC",
"USDT",
"DAI",
"USDE",
"GHO",
"CRVUSD",
"PYUSD",
"RLUSD",
"FRAX",
"USD1",
"USDY",
"USDG",
"AUSD",
"USDD",
"USD3",
"REUSD",
"USDX",
"USDF",
"USDAI",
"JUPUSD",
"AVUSD",
"BNB",
"AVAX",
"TRX",
"HYPE",
"LINK",
"XRP",
"POL",
"SKY",
"CRV",
"SUI",
"CVX",
"AERO",
"USYC",
"USTB",
"OUSG",
"USCC",
"TBILL",
"THBILL",
"ONYC",
"STBT",
"DOLA",
"FRXUSD",
"MSUSD",
"FXUSD",
"APXUSD",
"APYUSD",
"STRUSD",
"SYZUSD",
"STCUSD",
"USDU",
"SRUSD",
"BOLD",
"LISUSD",
"YUSD",
"BUCK",
"EURC",
"EURE"
]
},
"stablecoin": {
"type": "boolean",
"description": "Set to true to return only stablecoin assets."
},
"max_risk": {
"type": "string",
"description": "Only consider offers graded at or below this letter: A (lower risk), B (moderate), C (elevated), D (higher).",
"enum": [
"A",
"B",
"C",
"D"
]
},
"all": {
"type": "boolean",
"description": "Set to true for every asset with a live yield (about 60 entries, a large answer) instead of the headline assets. Ignored when asset or stablecoin is set."
}
}
}Output Schema
{
"type": "object",
"properties": {
"updated_at": {
"type": [
"string",
"null"
],
"description": "When the feed was last refreshed (ISO 8601). It refreshes every 3 hours."
},
"stale": {
"type": "boolean",
"description": "True when part of this snapshot is over 6 hours old (a scheduled refresh was missed)."
},
"partial": {
"type": "boolean",
"description": "True when a data source was missing from this snapshot."
},
"degraded_sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "The sources missing from this snapshot, if any."
},
"count": {
"type": "integer"
},
"yields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"asset": {
"type": "string"
},
"slug": {
"type": "string"
},
"best_apy": {
"type": [
"number",
"null"
],
"description": "The pick's rate in percent (5.2 means 5.2%) as its page shows it: today's rate, or its 7-day average when that is lower. An APR when rate_basis says so; the name is kept for compatibility. The pick is the by_grade step the risk-weighted ranking puts first, which can be a higher-risk step than grade A. Null when the asset has no pick yet (no_pick_reason)."
},
"best_rate_text": {
"type": [
"string",
"null"
],
"description": "best_apy as the page prints it, with its unit (\"0.17% APY\"): the figure to quote. Null with no pick."
},
"rate_basis": {
"type": "string",
"enum": [
"apy",
"apr",
"unknown"
],
"description": "Whether the source reports best_apy as an APY (compounded) or an APR; unknown when it does not say or there is no pick."
},
"best_platform": {
"type": [
"string",
"null"
]
},
"no_pick_reason": {
"type": [
"string",
"null"
],
"description": "Why the asset has no pick, as its page says under its top-ranked offer (e.g. \"the top-ranked offer, 18.5% APY on Pendle, is graded D, the highest risk\"). Relay it instead of a rate. Null when best_apy is set."
},
"risk_tier": {
"type": [
"string",
"null"
]
},
"stablecoin": {
"type": "boolean"
},
"peg_price": {
"type": [
"number",
"null"
],
"description": "For a stablecoin: the live price of the dollar the best yield is paid in (1 = on its $1 peg). Null when unpriced, not a stablecoin, or a dollar whose value accrues by design (Re's reUSD), which trades above $1."
},
"platform_count": {
"type": "integer"
},
"offer_count": {
"type": "integer"
},
"url": {
"type": "string",
"description": "The full comparison for this asset on BitcoinYield."
},
"by_grade": {
"type": "object",
"description": "The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade, both on its rate and on its rate without temporary rewards; between offers of one grade that pay about the same, the one paying materially more without temporary rewards is the pick.",
"properties": {
"A": {
"type": [
"object",
"null"
],
"properties": {
"rate": {
"type": "number",
"description": "The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."
},
"rate_text": {
"type": "string",
"description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote."
},
"rate_today": {
"type": "number",
"description": "The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."
},
"rate_rewards": {
"type": [
"number",
"null"
],
"description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate."
},
"rate_basis": {
"type": "string",
"enum": [
"apy",
"apr",
"unknown"
]
},
"platform": {
"type": "string"
},
"market": {
"type": "string",
"description": "The vault, market or token the rate is paid in."
},
"chain": {
"type": [
"string",
"null"
]
},
"us_available": {
"type": "string",
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether a US retail user can open it."
},
"url": {
"type": "string",
"description": "This grade's offers on the asset's page."
}
},
"required": [
"rate",
"rate_text",
"rate_today",
"rate_basis",
"platform",
"market",
"us_available",
"url"
]
},
"B": {
"type": [
"object",
"null"
],
"properties": {
"rate": {
"type": "number",
"description": "The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."
},
"rate_text": {
"type": "string",
"description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote."
},
"rate_today": {
"type": "number",
"description": "The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."
},
"rate_rewards": {
"type": [
"number",
"null"
],
"description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate."
},
"rate_basis": {
"type": "string",
"enum": [
"apy",
"apr",
"unknown"
]
},
"platform": {
"type": "string"
},
"market": {
"type": "string",
"description": "The vault, market or token the rate is paid in."
},
"chain": {
"type": [
"string",
"null"
]
},
"us_available": {
"type": "string",
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether a US retail user can open it."
},
"url": {
"type": "string",
"description": "This grade's offers on the asset's page."
}
},
"required": [
"rate",
"rate_text",
"rate_today",
"rate_basis",
"platform",
"market",
"us_available",
"url"
]
},
"C": {
"type": [
"object",
"null"
],
"properties": {
"rate": {
"type": "number",
"description": "The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."
},
"rate_text": {
"type": "string",
"description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote."
},
"rate_today": {
"type": "number",
"description": "The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."
},
"rate_rewards": {
"type": [
"number",
"null"
],
"description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate."
},
"rate_basis": {
"type": "string",
"enum": [
"apy",
"apr",
"unknown"
]
},
"platform": {
"type": "string"
},
"market": {
"type": "string",
"description": "The vault, market or token the rate is paid in."
},
"chain": {
"type": [
"string",
"null"
]
},
"us_available": {
"type": "string",
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether a US retail user can open it."
},
"url": {
"type": "string",
"description": "This grade's offers on the asset's page."
}
},
"required": [
"rate",
"rate_text",
"rate_today",
"rate_basis",
"platform",
"market",
"us_available",
"url"
]
}
},
"required": [
"A",
"B",
"C"
]
}
},
"required": [
"asset",
"best_apy",
"best_rate_text",
"rate_basis",
"best_platform",
"no_pick_reason",
"url",
"by_grade"
]
}
}
},
"required": [
"count",
"yields"
]
}🟢list_offers(asset, chain, max_risk, limit)
The top live yield offers for one asset (5 by default, up to 20) in BitcoinYield's own order: rate and risk together, with offers that have a month of steady history and $10M+ of liquidity first. Each offer carries its platform, chain, product type, rate (a percent, with rate_text, the figure to quote: "0.17% APY"), organic versus incentive split, 30-day average, liquidity, A-D risk grade with its main reasons, US availability, investor access, the platform's own deposit link and the page to cite. Filter by chain or a risk ceiling. Use it to compare options; list_yields gives one pick per asset. Rates are variable and not advice. No key required. When nothing matches, the answer says why: the filters, a dollar that lost its peg, or no live quote on the asset.
Input Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string",
"description": "The asset's symbol, e.g. BTC, USDC or USDE. For a token an asset is held as, give the asset: BTC for WBTC, ETH for stETH, DAI for USDS or sUSDS, SOL for jitoSOL (the tokens themselves are also read as their asset).",
"enum": [
"BTC",
"ETH",
"SOL",
"USDC",
"USDT",
"DAI",
"USDE",
"GHO",
"CRVUSD",
"PYUSD",
"RLUSD",
"FRAX",
"USD1",
"USDY",
"USDG",
"AUSD",
"USDD",
"USD3",
"REUSD",
"USDX",
"USDF",
"USDAI",
"JUPUSD",
"AVUSD",
"BNB",
"AVAX",
"TRX",
"HYPE",
"LINK",
"XRP",
"POL",
"SKY",
"CRV",
"SUI",
"CVX",
"AERO",
"USYC",
"USTB",
"OUSG",
"USCC",
"TBILL",
"THBILL",
"ONYC",
"STBT",
"DOLA",
"FRXUSD",
"MSUSD",
"FXUSD",
"APXUSD",
"APYUSD",
"STRUSD",
"SYZUSD",
"STCUSD",
"USDU",
"SRUSD",
"BOLD",
"LISUSD",
"YUSD",
"BUCK",
"EURC",
"EURE"
]
},
"chain": {
"type": "string",
"description": "Only offers on this chain, e.g. Ethereum, Base, Arbitrum or Solana (case-insensitive). Centralized (CeFi) offers have no chain."
},
"max_risk": {
"type": "string",
"description": "Only offers graded at or below this letter: A (lower risk), B (moderate), C (elevated), D (higher).",
"enum": [
"A",
"B",
"C",
"D"
]
},
"limit": {
"type": "integer",
"description": "How many offers to return, 1 to 20 (default 5).",
"minimum": 1,
"maximum": 20
}
},
"required": [
"asset"
]
}Output Schema
{
"type": "object",
"properties": {
"updated_at": {
"type": [
"string",
"null"
],
"description": "When the feed was last refreshed (ISO 8601). It refreshes every 3 hours."
},
"stale": {
"type": "boolean",
"description": "True when part of this snapshot is over 6 hours old (a scheduled refresh was missed)."
},
"partial": {
"type": "boolean",
"description": "True when a data source was missing from this snapshot."
},
"degraded_sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "The sources missing from this snapshot, if any."
},
"asset": {
"type": "string"
},
"count": {
"type": "integer"
},
"url": {
"type": "string",
"description": "The asset's full comparison on BitcoinYield."
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "The offer's place in BitcoinYield's order (rate and risk together), 1 first."
},
"platform": {
"type": "string",
"description": "The platform's name, e.g. Aave V3."
},
"chain": {
"type": [
"string",
"null"
],
"description": "The chain the offer is on; null for a centralized (CeFi) offer."
},
"market": {
"type": "string",
"description": "The vault, market or token the rate is paid in."
},
"product_type": {
"type": "string",
"description": "How the yield is produced, e.g. DeFi lending, Savings rate or Liquid staking."
},
"rate": {
"type": "number",
"description": "The annual rate in percent (5.2 means 5.2%) as BitcoinYield shows it and orders on it: the latest reading (rate_today), or its 7-day average when that is lower, so a one-day spike never leads. A DeFi rate is measured from the protocol's own contracts (what the deposit token actually earned) or read from the protocol's own API; an exchange's from its own API. Never a forecast."
},
"rate_text": {
"type": "string",
"description": "rate as BitcoinYield prints it, with its unit (\"0.17% APY\"): the figure to quote."
},
"rate_today": {
"type": "number",
"description": "The latest reading: for a lending market its latest day's rate, for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."
},
"rate_basis": {
"type": "string",
"enum": [
"apy",
"apr",
"unknown"
],
"description": "Whether the rate is an APY (compounded) or an APR. A rate measured from a protocol's contracts is an APY; a published rate keeps its source's convention; unknown when the source does not say."
},
"rate_base": {
"type": [
"number",
"null"
],
"description": "The organic part of rate (interest, fees, staking); rate_base + rate_rewards = rate."
},
"rate_rewards": {
"type": [
"number",
"null"
],
"description": "The part of rate paid as incentive rewards, which last only as long as someone funds them (beside a rate held at its 7-day average, scaled to that rate). Null when the source states no reward part: a rate measured from a protocol's contracts counts only what the deposit token itself earns, not incentives paid separately."
},
"avg_7d": {
"type": [
"number",
"null"
],
"description": "The rate's 7-day average (rate is the lower of it and rate_today)."
},
"rewards_program": {
"type": [
"object",
"null"
],
"description": "Who pays rate_rewards and how far ahead it is funded, when the incentive program is known (Merkl campaigns); null otherwise.",
"properties": {
"paid_in": {
"type": "array",
"items": {
"type": "string"
},
"description": "Reward token symbols."
},
"funded_through": {
"type": "string",
"description": "Last day (UTC, YYYY-MM-DD) the live round is funded through."
},
"since": {
"type": "string",
"description": "First day (UTC) of the unbroken run of rounds the live one belongs to."
},
"rounds": {
"type": "integer",
"description": "Rounds in that run, the live one included (1 = never renewed yet)."
},
"source": {
"type": "string",
"enum": [
"merkl"
]
}
},
"required": [
"paid_in",
"funded_through",
"since",
"rounds",
"source"
]
},
"avg_30d": {
"type": [
"number",
"null"
],
"description": "The rate's 30-day average; null under a month of history."
},
"durability": {
"type": [
"string",
"null"
],
"description": "The rate (as shown and ordered) against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when the larger of a realized rate's 7-day and 30-day returns is more than 1.6 times the smaller (income booked in lumps); insufficient under a month of history."
},
"liquidity_usd": {
"type": [
"number",
"null"
],
"description": "The liquidity a depositor can exit into, in US dollars: a lending pool's withdrawable amount, a credit pool's cash, or for a staking token what sells at once within 1% of its market price (the rest of its stake leaves through its issuer's queue, see exit), or for a fund its issuer redeems what its redemption vault pays at once. Null when the source reports none (custodial desks)."
},
"exit": {
"type": [
"string",
"null"
],
"description": "How a holder gets the underlying back at full value, as its issuer states it: a withdrawal queue, a cooldown or a redemption wait, and whether the token can also be sold on a market at the market price. Null when none is on record; a lending market's exit is its liquidity_usd."
},
"maturity": {
"type": [
"string",
"null"
],
"description": "For a fixed rate, the date it ends (YYYY-MM-DD): a Pendle principal token's maturity, when the locked rate stops and the token redeems for its underlying. Null for every other product."
},
"risk_tier": {
"type": [
"string",
"null"
],
"description": "BitcoinYield's A-D risk grade: A lower risk, D higher."
},
"risk_reasons": {
"type": [
"string",
"null"
],
"description": "The main factors behind the grade."
},
"us_available": {
"type": "string",
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether a US retail user can open it: no when the platform or issuer excludes US persons, or admits only accredited investors or invited addresses (see access)."
},
"access": {
"type": [
"string",
"null"
],
"description": "An investor restriction: KYC, Accredited only or Invite only."
},
"earn_url": {
"type": [
"string",
"null"
],
"description": "Where to deposit: the platform's own page."
},
"partner": {
"type": "boolean",
"description": "True when BitcoinYield may earn a commission through earn_url (it never changes the order)."
},
"rate_source_url": {
"type": [
"string",
"null"
],
"description": "Where anyone can check the rate: the contract it is read from, on a block explorer, or the exchange's or protocol's own page."
},
"fetched_at": {
"type": [
"string",
"null"
],
"description": "When this rate was read (ISO 8601)."
}
},
"required": [
"rank",
"platform",
"product_type",
"rate",
"rate_text",
"rate_today",
"rate_basis",
"us_available",
"partner"
]
}
}
},
"required": [
"asset",
"count",
"offers",
"url"
]
}Community
Evidence