MegaChad

Returns current $MEGACHAD token statistics: total supply, circulating supply, tokens burned, and total burn count.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a swap quote for buying $MEGACHAD with ETH on Kumbaya DEX (MegaETH). Returns router address, calldata params, and slippage-adjusted minimum output. Omit ethAmount for general swap info and contract addresses.

{
  "type": "object",
  "properties": {
    "ethAmount": {
      "description": "Amount of ETH to swap (e.g. \"0.1\"). Omit for general info.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the x402 payment requirements and $MEGACHAD burn requirements for looksmaxxing. Includes step-by-step instructions, contract addresses, and amounts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Browse recent looksmaxxed burns with IPFS image URLs, burner addresses, timestamps, and NFT token IDs.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Number of results (default 20, max 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "description": "Pagination offset (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the burner leaderboard ranked by total burns. Includes ERC-8004 reputation scores, .mega domain names, profile info, and all looksmaxxed images per burner.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns ERC-8004 registration metadata, on-chain agent identity (ID, owner, wallet), reputation client count, and contract addresses.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register a wallet for MegaChad testnet beta access. Checks on-chain eligibility ($MEGACHAD balance or looksmaxxed NFTs). Returns referral code and access status.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Ethereum wallet address (0x...)"
    },
    "twitter": {
      "description": "X/Twitter handle (optional for agents)",
      "type": "string"
    },
    "referralCode": {
      "description": "Referral code from existing registrant",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns ERC-721 metadata for a looksmaxxed NFT including image URL (IPFS or Warren on-chain), attributes, and storage properties.

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "string",
      "description": "NFT token ID (numeric string)"
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the current $MEGACHAD price in ETH from Kumbaya DEX, plus the estimated ETH cost to burn 225,000 tokens.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check a wallet's ETH balance, $MEGACHAD balance, NFT count, burn eligibility, and early access status.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Ethereum wallet address (0x...)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a complete, ordered set of transaction instructions for the full looksmaxx flow: swap → burn → tren fund → submit. Each step includes pre-built calldata ready to sign.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address (0x...)"
    },
    "ethAmount": {
      "description": "ETH to swap (e.g. \"0.5\"). Omit if wallet already has enough $MEGACHAD.",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get EIP-712 typed data for a gasless burn. Returns the signature payload a wallet must sign, plus approval status. After signing, POST the signature to /api/gasless/burn to relay the burn without paying gas.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register a wallet as a MegaChad referring agent. Returns registration transaction calldata and a referral code. Referring agents earn 10% of the tren fund portion (11,250 $MEGACHAD) for every burn they refer.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Agent wallet address (0x...)"
    },
    "mcpEndpoint": {
      "description": "Agent MCP server URL (optional)",
      "type": "string"
    },
    "description": {
      "description": "Agent description (optional)",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get referral statistics for a registered agent — total referrals, earnings, reward per burn, and calldata for referred burns.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Agent wallet address (0x...)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Send a plain English message and get back structured, actionable responses. Supports intents: price, stats, wallet, looksmaxx, swap, gallery, leaderboard, bridge, gasless, referral, about.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Natural language query (e.g. \"What is the current MEGACHAD price?\")"
    },
    "wallet": {
      "description": "Wallet address for context (0x...). Optional.",
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns bridge information for moving assets to MegaETH from Ethereum, Arbitrum, Base, and other chains. Lists canonical and aggregator bridges.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build a cross-chain looksmaxx plan from any supported chain (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB, Avalanche, Scroll, zkSync, Linea) to MegaETH. Returns step-by-step execution plan with bridge URLs, swap calldata, and burn instructions.

{
  "type": "object",
  "properties": {
    "sourceChain": {
      "type": "string",
      "description": "Source chain name (e.g. \"base\", \"arbitrum\", \"ethereum\")"
    },
    "wallet": {
      "description": "Wallet address for pre-built calldata (0x...)",
      "type": "string"
    },
    "amount": {
      "description": "ETH amount to bridge (e.g. \"0.15\")",
      "type": "string"
    },
    "referrer": {
      "description": "Referrer agent address for 5% commission (0x...)",
      "type": "string"
    }
  },
  "required": [
    "sourceChain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resolve a wallet address or .mega name into a unified MegaETH identity profile. Returns: MegaNames data, token balances, burn history & rank, reputation score, referral stats, tier level, and social links. Works as the social identity layer for MegaETH.

{
  "type": "object",
  "properties": {
    "addressOrName": {
      "type": "string",
      "description": "Wallet address (0x...) or .mega name (e.g. \"chad.mega\" or \"chad\")"
    }
  },
  "required": [
    "addressOrName"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get all MegaETH token balances for a wallet: ETH, WETH, $MEGACHAD, USDm. Returns formatted balances with raw values.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Canonical machine-readable registry of every MEGA Protocol contract: tokens (MEGACHAD, MEGAGOONER), AMM pair (MC/MG), staking (MoggerStaking, JESTERGOONER), governance (Jestermogger, NFTVetoCouncil, Framemogger), emissions (EmissionController), and safety (CircuitBreaker). Includes addresses, proxy/impl, ABIs, known gotchas, and direct links to all agent endpoints. Pull this FIRST for any DeFi interaction.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns combined position across both staking venues: MoggerStaking (stake MEGACHAD → earn MEGAGOONER) and JESTERGOONER V4 (stake MC/MG LP → earn MEGAGOONER). Includes balances, allowances, earned rewards, NFT boost, APR, and global pool stats. Without address, returns global stats only.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Wallet address (0x...) — optional, gives per-wallet position",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns ready-to-sign transactions for stake / unstake / claim on either MoggerStaking (venue=mogger, stake MEGACHAD) or JESTERGOONER V4 (venue=jester, stake MC/MG LP). Stake actions return approve+stake; unstake/claim return a single tx. Each item has { to, value, data } you can pass to eth_sendTransaction.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "stake",
        "unstake",
        "claim"
      ],
      "description": "Which action to build"
    },
    "venue": {
      "type": "string",
      "enum": [
        "mogger",
        "jester"
      ],
      "description": "mogger = MoggerStaking (MEGACHAD), jester = JESTERGOONER V4 (LP)"
    },
    "amount": {
      "description": "Amount in human units (e.g. \"1000\"). Required for stake/unstake.",
      "type": "string"
    },
    "address": {
      "description": "Wallet address — used to skip approve if allowance is sufficient",
      "type": "string"
    }
  },
  "required": [
    "action",
    "venue"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Quote a swap on the MegaChadLP MC/MG pair (constant-product, 0.3% fee). Returns expected output, price impact, and spot prices. WARNING: this pair uses tokenA/tokenB instead of token0/token1 so standard Uniswap V2 routers do not detect it — use this tool. Omit `from` + `amount` to just inspect reserves.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Input token: MC (MEGACHAD) or MG (MEGAGOONER)",
      "type": "string",
      "enum": [
        "MC",
        "MG"
      ]
    },
    "amount": {
      "description": "Input amount in human units (e.g. \"1000\")",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build a two-step plan to swap MEGACHAD↔MEGAGOONER through MegaChadLP: ERC20.transfer(pair, amountIn) → pair.swap(amountAIn, amountBIn, to). MegaChadLP has no on-chain minOut — verify your received balance after the swap. Slippage is computed off-chain and surfaced as minOut.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "enum": [
        "MC",
        "MG"
      ],
      "description": "Input token"
    },
    "amount": {
      "type": "string",
      "description": "Input amount in human units (e.g. \"1000\")"
    },
    "recipient": {
      "type": "string",
      "description": "Receive address (0x...)"
    },
    "slippageBps": {
      "description": "Slippage tolerance in bps (default 200 = 2%)",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    }
  },
  "required": [
    "from",
    "amount",
    "recipient"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build approve(MC) + approve(MG) + addLiquidity on MegaChadLP MC/MG. The pair refunds whichever side is over-supplied. LP shares returned are stake-eligible in JESTERGOONER V4.

{
  "type": "object",
  "properties": {
    "amountMC": {
      "type": "string",
      "description": "MEGACHAD amount in human units"
    },
    "amountMG": {
      "type": "string",
      "description": "MEGAGOONER amount in human units"
    },
    "recipient": {
      "type": "string",
      "description": "LP token recipient (0x...)"
    },
    "address": {
      "description": "Sender address — used to skip approve steps if allowance is sufficient",
      "type": "string"
    }
  },
  "required": [
    "amountMC",
    "amountMG",
    "recipient"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List recent Jestermogger governance proposals with state (Pending / Active / Defeated / Succeeded / Queued / Executed / Expired / Vetoed), vote tallies, timing, and per-proposal lookup URLs.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Number of proposals (default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full state for one Jestermogger proposal: actions (target/value/calldata), vote tally, NFT veto council status, and (if voter passed) the voter receipt with vote weight.

{
  "type": "object",
  "properties": {
    "proposalId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Proposal ID (1-indexed)"
    },
    "voter": {
      "description": "Voter address to look up receipt",
      "type": "string"
    }
  },
  "required": [
    "proposalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build a castVote tx on Jestermogger. Support values: for | against | abstain. Vote weight = your MEGAGOONER balance at proposal snapshot.

{
  "type": "object",
  "properties": {
    "proposalId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Proposal ID"
    },
    "support": {
      "type": "string",
      "enum": [
        "for",
        "against",
        "abstain"
      ],
      "description": "Vote direction"
    }
  },
  "required": [
    "proposalId",
    "support"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the full 225-week MEGAGOONER emission schedule plus current week, on-chain weekly emission, and the EmissionController split (mogger / jester / treasury). Formula: 662245 * ((225 - w) / 225)^2 MEGAGOONER per week.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build queue(proposalId) calldata for a Succeeded Jestermogger proposal. Starts the 2-day timelock — after that, the proposal can be executed.

{
  "type": "object",
  "properties": {
    "proposalId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Proposal ID (1-indexed)"
    }
  },
  "required": [
    "proposalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build execute(proposalId) calldata for a Queued Jestermogger proposal past its 2-day timelock. May be payable if any action carries ETH value.

{
  "type": "object",
  "properties": {
    "proposalId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Proposal ID"
    }
  },
  "required": [
    "proposalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

GET form returns Framemogger top-3-burner eligibility for the proposer (only top 3 can propose each week). To actually build calldata, POST your { targets[], values[], calldatas[], description } payload to /api/defi/governance/propose-tx. Use this MCP tool to quickly check eligibility before drafting.

{
  "type": "object",
  "properties": {
    "proposer": {
      "description": "Proposer wallet address (0x...) — required for eligibility check",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build castVetoVote calldata on NFTVetoCouncil. support yes = veto, no = defend. If no veto window has been opened for the proposal, the response includes an extra startVetoVote() step. Voter is optional — providing it checks council-membership + duplicate-vote state.

{
  "type": "object",
  "properties": {
    "proposalId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Proposal ID"
    },
    "support": {
      "description": "yes = veto, no = defend (default yes)",
      "type": "string",
      "enum": [
        "yes",
        "no"
      ]
    },
    "voter": {
      "description": "Voter wallet address (0x...) — checks council-membership status",
      "type": "string"
    }
  },
  "required": [
    "proposalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MEGACHADNFT count for a wallet + boost tier (1+/10+/25+) + verdict on staking-reward eligibility (1+ NFT required). Use this BEFORE building any stake tx — a wallet with 0 NFTs accrues 0 rewards even when staked.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CircuitBreaker state (paused?, guardian votes, auto-unpause timer) + NFTVetoCouncil composition (20 seats, threshold, current members). Critical context BEFORE sending any write — if paused, every staking/AMM/governance write reverts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Unified time-ordered feed of recent on-chain events across the MEGA Protocol stack: burns, Framemogger sends, stakes / unstakes / claims (Mogger + Jester), proposal lifecycle (created / voted / queued / executed). Defaults: last 2000 blocks (~8 min on MegaETH), 50 events.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max events to return (default 50, max 200)",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "blocks": {
      "description": "Block window to scan (default 2000)",
      "type": "integer",
      "minimum": 100,
      "maximum": 50000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Master directory of every MegaChad endpoint, MCP tool, manifest URL, and example. The recommended first call for any agent — returns the complete surface in a single response.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a curated directory of protocols on MegaETH: DEXes, bridges, payment infra, storage, identity systems. Includes contract addresses, features, and links.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}