stakechain-mcp
This server provides a comprehensive yield and lending aggregator for the Base network, allowing users and agents to discover, evaluate, and identify stable high-rate opportunities.
List and filter all available staking and lending yield opportunities on Base, considering metrics like TVL and APY.
Identify the highest-performing yield rate for a specific asset while applying quality filters.
Access specific contract details (e.g.,
depositToaddresses) for actionable lending markets (Aave, Moonwell, Morpho).Assess the risk and quality of a market using detailed profiles (including size, stability, and curator fees).
Verify the stability of a claimed APY by viewing its historical performance and volatility.
Integrates with Coinbase's x402 facilitator to settle machine payments on-chain in USDC for paid API requests, with a fallback EIP-3009 settler.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
StakeChain Labs
⚠️ Retired 2026-11-05 — not maintained
This project is finished. The daily and weekly schedules are off, nothing is being updated, and no claim below should be read in the present tense.
It was built to sell DeFi rate data to machines over x402. It worked, and it earned $0.008 a month. Sweeping the entire x402 discovery index — 3,315 sellers — showed total market revenue of $96,010 per 30 days, of which 71.9% is one gift-card checkout endpoint, and 2,736 sellers earn under $1 a month. There is no price at which selling data on that rail pays.
Read POSTMORTEM.md for the numbers, the three conclusions the data overturned, and what is worth taking from the code. The deployed links below may still respond; they are not being watched.
Live: landing · dashboard · API · contract on BaseScan · Blockscout
STACH is tradeable: Uniswap v4 pool STACH/ETH live on Base (initial price 4,000,000 STACH/ETH) — routable through aggregators (LI.FI verified).
An open staking-yield experiment on Base. Live aggregator of staking and lending rates across Base protocols — readable by humans on a dashboard, consumable by AI agents over MCP, payable by machines over x402.
No seed round. No token presale. Just a running, open-source experiment. Concept and plan: docs/PIVOT-2026.md.
Related MCP server: usenami-mcp
The product
Piece | What it does |
Base yields aggregator with junk-farm filters, rate history and market profiles. Aave and Moonwell are read from their own contracts, not a third-party snapshot; x402 machine-payment endpoints | |
MCP server (5 tools, on npm) + runnable recipes + a resident analyst that pays the public API for its own data | |
React dashboard: Base Yields, Earn (Morpho, Aave, Moonwell), Borrow, Swap, STACH staking, Portfolio | |
| |
Landing page (static, GitHub-Pages-ready) |
Legacy 2021–2023 material (Laravel site, old static site, branding, original docs) is kept under website-laravel/, website-static/, branding/, docs/.
Monetization: machines pay, on-chain, automatically — LIVE
Human endpoints (/yields, /vaults) are free. Machine endpoints
(/v1/*) speak the x402 protocol with enforcement
on: HTTP 402 + payment requirements → the client signs an EIP-3009
USDC authorization ($0.001/request) → it settles on-chain through the
Coinbase facilitator, with our own EIP-3009 settler as the fallback (no
accounts, no API keys either way). Revenue lands at the admin wallet; api/pay-client.js is a reference
paying client.
Embeddable badges: live rates as SVG for any README — see docs/BADGES.md. No key, no signup.
API reference: docs/API.md — endpoints, the x402 flow, MCP tools and what each one answers.
Rate history: /history?pool=<id>&days=30
answers the question a live APY cannot — has this rate held, or did it
appear yesterday? Daily snapshots are committed to
data/history/ in this repo, so the series is verifiable
and survives us. Agents get it as the yield_history tool.
Pricing: ~$0.001/request (pure x402; the three data routes differ by a
millionth of a dollar so the settled transfer names which one was bought), or
subscriptions bought with a
single x402 payment — Developer $19/30d, Professional $99/30d (GET /v1/subscribe/<tier> returns a signed X-API-KEY that skips per-request
payments). Public stats: /stats
reports payment counts and revenue computed from on-chain USDC transfers —
verifiable by anyone on BaseScan.
Real yield: collected USDC is distributed to STACH stakers through
RevenueDistributor
(verified; merkle epochs reproducible from public state via
contracts/scripts/revenue-snapshot.js, 180-day sweep-back).
MCP config
The yields aggregator is an MCP server, published on npm as
stakechain-mcp. Add it to
any MCP-compatible client:
{
"mcpServers": {
"stakechain": { "command": "npx", "args": ["-y", "stakechain-mcp"] }
}
}Quickstart
# 1. Yields API
cd api && npm install && npm start # :4000
# 2. Dashboard
cd dashboard && npm install --legacy-peer-deps
npm start # :3000, reads the API
# 3. Give the data to your AI agent (published on npm, no clone needed)
claude mcp add stakechain -- npx -y stakechain-mcp
# 4. Contracts (test + cheap deploy)
cd contracts && npm install
npx hardhat test # 38 tests
npm run deploy:baseSepolia # free testnetSTACH token
Deployed at the same address on both networks (verified via Sourcify, exact match):
Base mainnet:
0x82c5f9901CD9AEE3177053482b79aEA235507166· BlockscoutArbitrum One (canonical wrapped, LayerZero OFT): same address,
0x82c5…7166— real STACH stays locked on Base (bridge docs)Base Sepolia:
0x82c5f9901CD9AEE3177053482b79aEA235507166
Initial holder / admin: 0x2Ab5A19aabc599C1a24CC0541ECB757b56976661. The
dashboard targets mainnet by default; set REACT_APP_CHAIN=baseSepolia for
the testnet.
Fixed supply 42M. At deployment: 3M held by the contract as the staking
reward reserve (1M flexible / 2M locked over 360 days), 39M to the admin
wallet. The admin wallet now holds none of it: on 2026-10-31 it moved
24.43M (58.16% of supply) into a Dutch auction and a Uniswap v4 pool
initializer — see the table below and
docs/TOKENOMICS.md. The 2022
contract had two critical bugs (recipient-burning transferFrom, unbacked
reward minting) — fixed and regression-tested in 2026:
docs/AUDIT-2026-10.md.
The distributor above is deployed and verified, but carries no meaningful
revenue yet — /stats reports the
real figure, including how much came from our own agent. Revenue first,
distribution second: the mechanism exists so it can be checked, not because
there is something to distribute.
Supply transparency
Full detail, including lock schedules and the usage-rewards budget: docs/TOKENOMICS.md.
Every STACH is accounted for (snapshot 2026-11-02, verify on-chain):
Holder | Address | STACH | Share |
Dutch auction — 58.16% of supply was moved here and to the initializer below on 2026-10-31; terms not yet published, nothing sold so far | 12.21M | 29.08% | |
Uniswap v4 pool initializer for that auction | 12.21M | 29.08% | |
Uniswap v4 STACH/ETH pool liquidity (not locked) | 8.14M | 19.39% | |
Timelocked treasury — locked until 2027-04-28, linear to 2028-10-19, no owner and no recovery path | 6.30M | 15.00% | |
Staking reward reserve (3M) + user stakes, held by the token contract | 3.03M | 7.22% | |
Deployer (deploys contracts, pays usage rewards) | ~100k | 0.24% | |
Treasury / operations — now empty | 0 | 0% |
15% sits in a verified timelock with no owner, no pause and no recovery function, and 7.22% is the staking reward reserve the token contract can only pay to stakers. About 80% of supply has never been in public hands — the auction and its initializer hold 58.16% between them, and the auction's terms are not published yet, so we cannot tell you here when or at what price those tokens reach the market. Concentration flags remain entirely fair; this table exists so the claim can be checked rather than trusted.
Honest part
This is an experiment, not "the future of finance". Everything here is MIT-licensed, the audit is public, the data endpoints filter out obvious degen traps (min TVL, APY ceiling, no-IL default). Nothing in this repository is financial advice.
Available Tools
5 toolsbest_yieldBest rate for one assetARead-onlyInspect
The single highest-APY pool on Base for one asset, with junk-farm filters applied (minimum TVL, APY ceiling, no impermanent-loss exposure by default). Use it for a direct 'where is the best rate for X' question. It ranks by rate alone, so before committing capital check market_profile for what the curator charges and yield_history for whether the rate has held.
Inputs: asset (required).
list_base_yieldsList Base yield opportunitiesARead-onlyInspect
Survey staking and lending opportunities on Base: APY, TVL, project and asset for each. Use this to see the landscape or to answer 'what is available', and use best_yield instead when one asset's single best option is wanted. Results already exclude obvious traps (minimum TVL, APY ceiling). Returns market data, not a recommendation; the pool id of any row can be passed to yield_history.
Inputs: asset, minTvl, stable, sortByApy.
list_lending_vaultsDeposit-ready lending marketsARead-onlyInspect
The Base lending shelf an agent can actually act on: Morpho ERC-4626 vaults, Aave V3 reserves and Moonwell markets, each with the contract address to deposit into (depositTo) and the asset's address and decimals. Morpho entries also carry a risk block: curator fee, vault age, allocation concentration, and how much of the APY comes from incentives rather than borrower interest. Aave and Moonwell rates are read from their own contracts, so markets missing from aggregator snapshots appear here.
Inputs: no named parameters.
market_profileWhat to weigh besides the rateARead-onlyInspect
Risk profile for one Morpho vault or Aave reserve, for use before committing capital. Returns score (0-100) and band ('solid', 'fair', 'thin' or 'fragile'), plus a signals object holding the six inputs behind it: size (TVL), track_record (days running), stability (APY volatility from daily snapshots), yield_quality (share of the APY that is borrower interest rather than incentives that can stop), cost (the curator's percentage cut) and diversification (share sitting in the largest position). Each signal carries its raw value and its sub-score, and method.weights gives the weighting, so the score can be recomputed. A signal lacking data reports score null and is excluded from the weighting rather than guessed at. Pair with yield_history for an unusually high rate. Describes what has happened, not what will.
Inputs: pool (required).
yield_historyHas this rate held?ARead-onlyIdempotentInspect
Daily APY and TVL history for one market, with min, median, max and volatility over the window. Answers the question a live rate cannot: whether today's APY is typical for this market or a spike that appeared yesterday. Call it before acting on any unusually high rate. observations says how many daily snapshots exist — a market added recently will have few, and a short series should not be read as stability.
Inputs: pool (required), days.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct analytical role: broad surveying, single-best selection, actionable lending vaults, historical APY, and risk profiling. The descriptions explicitly steer agents between overlapping-looking tools such as `list_base_yields` and `best_yield`, and between `list_lending_vaults` and the broader survey.
All names use snake_case, but the pattern mixes verb-first list tools with noun-phrase tools such as `best_yield`, `yield_history`, and `market_profile`. The convention is readable but not predictable across the set.
Five tools is a well-scoped set for yield discovery and risk assessment on Base. Each tool covers a distinct stage of the workflow: survey, rank, act, verify history, and assess risk.
The surface covers discovery, best-rate lookup, actionable lending vaults, historical APY, and risk profiling, giving strong coverage for research and pre-deposit checks. A minor gap is that staking opportunities are listed but do not appear to include actionable deposit addresses like the lending vaults do.
Maintenance
Related MCP Connectors
Paid DeFi data for agents via x402 on Base: yields, APY moves, stablecoin pegs, token risk.
Crypto yield data for AI agents: lending, savings, staking, borrowing & stablecoin rates. 21 tools.
Pay-per-call agent tools on Base: market pulse, USDC stats, crypto prices, JSON repair, DNS, URLs.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Related MCP Servers
AlicenseAqualityDmaintenanceAutonomous DeFi yield for AI agents on Base. Query APY rates, agent status, payment splits, and referral stats. 4 read-only tools + 1 resource.92MIT
usenami-mcpofficial
AlicenseAqualityFmaintenancePerp-first funding rate & RWA spread data for AI agents. 30+ CEX/DEX venues, 6 tools (4 x402-paywalled, 2 free), bring-your-own-wallet via Base mainnet.61MIT- AlicenseBqualityFmaintenanceReal-time crypto, stock, and prediction-market data for agents — prices, indicators, funding rates, DeFi TVL, macro calendar, and an AI momentum score. Configure one Base wallet key and it just works. No signup, no dashboard, no subscription.22265 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to access crypto prices, DeFi yields, Polymarket data, Base chain info, and security scans with pay-per-call via USDC on Base mainnet.MIT