Skip to main content
Glama

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.

CI npm License: MIT stakechain-mcp MCP server – quality and maintenance score on Glama mcptry

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

api/

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

agents/

MCP server (5 tools, on npm) + runnable recipes + a resident analyst that pays the public API for its own data

dashboard/

React dashboard: Base Yields, Earn (Morpho, Aave, Moonwell), Borrow, Swap, STACH staking, Portfolio

contracts/

STACH token + flexible/locked staking — audited & hardened (audit), plus the treasury timelock — 38 tests

website/

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.

Aave USDC Spark USDC x402 payments

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 testnet

STACH token

Deployed at the same address on both networks (verified via Sourcify, exact match):

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

0xBd0c…FecC7

12.21M

29.08%

Uniswap v4 pool initializer for that auction

0xf101…6000

12.21M

29.08%

Uniswap v4 STACH/ETH pool liquidity (not locked)

0x4985…2b2b

8.14M

19.39%

Timelocked treasury — locked until 2027-04-28, linear to 2028-10-19, no owner and no recovery path

0x6425…D69C

6.30M

15.00%

Staking reward reserve (3M) + user stakes, held by the token contract

0x82c5…7166

3.03M

7.22%

Deployer (deploys contracts, pays usage rewards)

0x2974…734F

~100k

0.24%

Treasury / operations — now empty

0x2Ab5…6661

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 tools
best_yieldBest rate for one assetA
Read-only
Inspect

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 opportunitiesA
Read-only
Inspect

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 marketsA
Read-only
Inspect

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 rateA
Read-only
Inspect

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?A
Read-onlyIdempotent
Inspect

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

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Perp-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.
      6
      1
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      Real-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.
      22
      265 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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