{
 "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": null
 },
 "pricing": {
  "public": "0.002 BNB",
  "inviteCoupon": "free while quota lasts"
 },
 "fees": {
  "hatch": "0.0005 BNB",
  "hatchling": "0.0003 BNB",
  "juvenile": "0.0006 BNB",
  "adult": "0.0010 BNB",
  "marketFeeBps": 200,
  "royaltyBps": 500
 },
 "timing": {
  "hatchDelaySeconds": 21600,
  "feedCooldownSeconds": 3600,
  "note": "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",
  "traits": "/meso/meta/traits.json",
  "rpc": "/meso/rpc",
  "sdk": "https://github.com/996688P/meso-sdk",
  "mcp": "/meso/mcp",
  "actions": "/meso/api/meso/actions?address={address}",
  "action": "/meso/api/meso/action?address={address}&step={mint|hatch|feed|evolve}&tokenId={id}"
 },
 "flow": [
  "GET /meso/api/stats and verify contract addresses + minted count",
  "Read current price, supply and caps, then call mint() with value=price",
  "call mintWithCoupon(nonce, referrer, signature), or mint() with 0.002 BNB",
  "wait for hatchDelay() (currently 6h), then call hatch(tokenId) with 0.0005 BNB - rarity is revealed",
  "feed(tokenId) on feedCooldown() (currently 1h) with the exact stage fee 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_quickstart",
   "meso_simulate",
   "meso_build_tx"
  ]
 },
 "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_overview",
   "meso_specimen",
   "meso_specimens",
   "meso_reserve",
   "meso_excavation_rules",
   "meso_verify",
   "meso_contracts",
   "meso_docs"
  ],
  "note": "Read-only tools. For writes, use meso_contracts to get addresses + signatures and sign locally."
 }
}