{
 "name": "MESO PROTOCOL",
 "description": "Mesozoic specimen protocol on BNB Chain: fixed supply 3000, on-chain lifecycle (egg -> hatchling -> juvenile -> adult -> ascended), 5% ERC-2981 royalty shared with ascended holders.",
 "chain": {
  "name": "BNB Smart Chain",
  "chainId": 56
 },
 "contracts": {
  "nft": "0x054237fe97dad04FB51526dB15aA386075054710",
  "market": "0xc88244FbCEdF927D7BBBc05B8f3090979d903281",
  "floorFund": "0x297F97be9f16bec1f85c1A8d37b0eca9C9B68dF3"
 },
 "standards": [
  "ERC-721",
  "ERC-2981"
 ],
 "supply": {
  "max": 3000,
  "ascendedCap": 300,
  "maxPerWallet": 3,
  "minted": 36
 },
 "pricing": {
  "public": "first mint free per address; paid mints follow an upward ladder (currently 0.0005 BNB)",
  "mint": "first 300 genesis slots are free via coupon; later mints pay price(), an upward ladder (0.0005/0.001/0.002/0.004/0.008) keyed to supply, never decreasing; max 3 per wallet",
  "note": "first mint per address is free; later mints pay price(), an upward ladder keyed to supply"
 },
 "fees": {
  "hatch": "0 BNB (free)",
  "hatchling": "0.00005 BNB",
  "juvenile": "0.0001 BNB",
  "adult": "0.00015 BNB",
  "marketFeeBps": 200,
  "royaltyBps": 500,
  "source": "live values; verify with hatchFee()/feedFee() or /meso/api/stats"
 },
 "timing": {
  "hatchDelaySeconds": 3600,
  "feedCooldownSeconds": 3600,
  "note": "1h each at time of writing; owner-adjustable, read hatchDelay()/feedCooldown() or /api/stats"
 },
 "endpoints": {
  "stats": "/meso/api/stats",
  "quickstart": "/meso/quickstart.json",
  "health": "/meso/api/health",
  "manifest": "/meso/agents.json",
  "guide": "/meso/agents.md",
  "llms": "/meso/llms.txt",
  "abi": "/meso/meta/abi.json",
  "marketAbi": "/meso/meta/market-abi.json",
  "marketAbiNote": "NFT ABI is in `abi`. Secondary market (0xc88244Fb) and floor fund (0x297F97be) are in `marketAbi`, with every selector verified against deployed runtime bytecode.",
  "traits": "/meso/meta/traits.json",
  "rpc": "/meso/rpc",
  "rpcNote": "POST only (JSON-RPC 2.0). GET returns 404 by design; do not use GET to probe liveness.",
  "sdk": "https://github.com/996688P/meso-sdk",
  "mcp": "/meso/mcp",
  "actions": "/api/meso/actions?address={address}",
  "marketSnapshot": "/api/meso/market",
  "marketMine": "/api/meso/market/mine?address={address}",
  "marketHistory": "/api/meso/market/history?limit=50",
  "marketStatus": "/api/meso/market/status",
  "marketNote": "listings()/offers() are single-slot per token, so the contract cannot answer \"who bid on mine\" or \"what changed recently\". These endpoints serve a snapshot-diff index built by re-reading every token and comparing against the previous scan (public nodes reject eth_getLogs). marketMine returns offer_received, which is not readable from the contract. Caveat: a listing created and cancelled between two scans leaves no trace, and a sale shows up as a disappeared listing.",
  "action": "/api/meso/action?address={address}&step={mint|hatch|feed|evolve|list|delist|buy|makeOffer|acceptOffer|withdrawOffer|approveMarket|fundSell}&tokenId={id}",
  "actionNote": "list needs &price= in BNB; makeOffer needs &amount= in BNB. Every step returns an unsigned tx plus an eth_call precheck. No signature is required to obtain the tx.",
  "skill": "/meso/skills/meso-protocol/SKILL.md",
  "skillNote": "面向外部 agent 的操作手册：先 plan 再 preflight 后广播，含授权风险与已知局限。references/ 下有接口字段与选择器表。"
 },
 "flow": [
  "GET /meso/api/stats and verify contract addresses, minted count and live fees",
  "call mint() with value = price(); the ladder only moves up",
  "or, if you hold an invite signature: mintWithInvite(nonce, referrer, signature) - costs no BNB, one per coupon",
  "wait hatchDelay() (currently 1h), then call hatch(tokenId) with hatchFee() (currently 0) - rarity is revealed",
  "feed(tokenId) on feedCooldown() (currently 1h) with the exact stage fee (0.00005 / 0.0001 / 0.00015 BNB) to gain XP",
  "call evolve(tokenId) at 100/300/700 XP; ascended is capped at 300"
 ],
 "safety": [
  "Verify contract addresses before every call",
  "Never send more than the exact fee",
  "Rarity is not true randomness; it derives from blockhash",
  "Metadata is served from this domain, not IPFS",
  "No floor price is promised; buyback depends on floor fund balance"
 ],
 "sdk": {
  "repo": "https://github.com/996688P/meso-sdk",
  "license": "MIT",
  "language": "JavaScript",
  "mcpTools": [
   "meso_stats",
   "meso_token",
   "meso_listings",
   "meso_coupon",
   "meso_build_tx"
  ],
  "mcpToolsNote": "These are the npm package's own tool names and differ from the hosted MCP tool names below. Do not mix the two sets."
 },
 "mcp": {
  "transport": "streamable-http (JSON-RPC 2.0 over POST)",
  "endpoint": "https://hongwu.cloud/meso/mcp",
  "quickstart": "mcp add meso https://hongwu.cloud/meso/mcp",
  "tools": [
   "meso_build_tx",
   "meso_contracts",
   "meso_docs",
   "meso_excavation_rules",
   "meso_genesis",
   "meso_genesis_apply",
   "meso_overview",
   "meso_plan",
   "meso_preflight",
   "meso_reserve",
   "meso_session",
   "meso_specimen",
   "meso_specimens",
   "meso_supply",
   "meso_tx_status",
   "meso_verify",
   "meso_waitlist"
  ],
  "note": "Call tools/list for the authoritative set; the list above is a snapshot. meso_build_tx and meso_preflight return UNSIGNED transactions. Read-only tools never touch a private key. Sign locally and broadcast yourself."
 }
}