MCP Server

MegaChad

io.github.megachadxyz/megachad
Crypto & Web3 Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Provides MegaETH DeFi, NFT, staking, token, governance, bridge, portfolio, and transaction-building capabilities for the MegaChad ecosystem.

build_amm_add_liquidity_tx
Build Add Liquidity Transaction
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['amountMC', 'amountMG', 'recipient'], 'properties': {'address': {'type': 'string', 'description': 'Sender address â\x80\x94 used to skip approve steps if allowance is sufficient'}, '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...)'}}}
build_amm_swap_tx
Build MC↔MG Swap Transaction
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'amount', 'recipient'], 'properties': {'from': {'enum': ['MC', 'MG'], 'type': 'string', 'description': 'Input token'}, 'amount': {'type': 'string', 'description': 'Input amount in human units (e.g. "1000")'}, 'recipient': {'type': 'string', 'description': 'Receive address (0x...)'}, 'slippageBps': {'type': 'integer', 'maximum': 5000, 'minimum': 0, 'description': 'Slippage tolerance in bps (default 200 = 2%)'}}}
build_execute_tx
Build Execute Proposal TX
Build execute(proposalId) calldata for a Queued Jestermogger proposal past its 2-day timelock. May be payable if any action carries ETH value.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposalId'], 'properties': {'proposalId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Proposal ID'}}}
build_propose_tx
Build Propose TX / Check Eligibility
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'proposer': {'type': 'string', 'description': 'Proposer wallet address (0x...) â\x80\x94 required for eligibility check'}}}
build_queue_tx
Build Queue Proposal TX
Build queue(proposalId) calldata for a Succeeded Jestermogger proposal. Starts the 2-day timelock — after that, the proposal can be executed.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposalId'], 'properties': {'proposalId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Proposal ID (1-indexed)'}}}
build_staking_tx
Build Staking Transaction
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'venue'], 'properties': {'venue': {'enum': ['mogger', 'jester'], 'type': 'string', 'description': 'mogger = MoggerStaking (MEGACHAD), jester = JESTERGOONER V4 (LP)'}, 'action': {'enum': ['stake', 'unstake', 'claim'], 'type': 'string', 'description': 'Which action to build'}, 'amount': {'type': 'string', 'description': 'Amount in human units (e.g. "1000"). Required for stake/unstake.'}, 'address': {'type': 'string', 'description': 'Wallet address â\x80\x94 used to skip approve if allowance is sufficient'}}}
build_veto_tx
Build NFT Veto TX
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposalId'], 'properties': {'voter': {'type': 'string', 'description': 'Voter wallet address (0x...) â\x80\x94 checks council-membership status'}, 'support': {'enum': ['yes', 'no'], 'type': 'string', 'description': 'yes = veto, no = defend (default yes)'}, 'proposalId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Proposal ID'}}}
build_vote_tx
Build Vote Transaction
Build a castVote tx on Jestermogger. Support values: for | against | abstain. Vote weight = your MEGAGOONER balance at proposal snapshot.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposalId', 'support'], 'properties': {'support': {'enum': ['for', 'against', 'abstain'], 'type': 'string', 'description': 'Vote direction'}, 'proposalId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Proposal ID'}}}
chat_with_megachad
Chat with MegaChad
Send a plain English message and get back structured, actionable responses. Supports intents: price, stats, wallet, looksmaxx, swap, gallery, leaderboard, bridge, gasless, referral, about.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'wallet': {'type': 'string', 'description': 'Wallet address for context (0x...). Optional.'}, 'message': {'type': 'string', 'description': 'Natural language query (e.g. "What is the current MEGACHAD price?")'}}}
cross_chain_looksmaxx
Cross-Chain Looksmaxx
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sourceChain'], 'properties': {'amount': {'type': 'string', 'description': 'ETH amount to bridge (e.g. "0.15")'}, 'wallet': {'type': 'string', 'description': 'Wallet address for pre-built calldata (0x...)'}, 'referrer': {'type': 'string', 'description': 'Referrer agent address for 5% commission (0x...)'}, 'sourceChain': {'type': 'string', 'description': 'Source chain name (e.g. "base", "arbitrum", "ethereum")'}}}
gasless_burn_info
Get Gasless Burn Info
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Wallet address (0x...)'}}}
get_activity_feed
Get MEGA Protocol Activity Feed
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max events to return (default 50, max 200)'}, 'blocks': {'type': 'integer', 'maximum': 50000, 'minimum': 100, 'description': 'Block window to scan (default 2000)'}}}
get_agent_index
Get MegaChad Agent Index
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_agent_info
Get MegaChad Agent Info
Returns ERC-8004 registration metadata, on-chain agent identity (ID, owner, wallet), reputation client count, and contract addresses.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_amm_quote
Get MEGACHAD/MEGAGOONER AMM Quote
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'from': {'enum': ['MC', 'MG'], 'type': 'string', 'description': 'Input token: MC (MEGACHAD) or MG (MEGAGOONER)'}, 'amount': {'type': 'string', 'description': 'Input amount in human units (e.g. "1000")'}}}
get_bridge_info
Get Bridge Info
Returns bridge information for moving assets to MegaETH from Ethereum, Arbitrum, Base, and other chains. Lists canonical and aggregator bridges.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_chadboard
Get Chadboard Leaderboard
Returns the burner leaderboard ranked by total burns. Includes ERC-8004 reputation scores, .mega domain names, profile info, and all looksmaxxed images per burner.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_emission_schedule
Get MEGAGOONER Emission Schedule
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_gallery
Get Looksmaxx Gallery
Browse recent looksmaxxed burns with IPFS image URLs, burner addresses, timestamps, and NFT token IDs.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of results (default 20, max 50)'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset (default 0)'}}}
get_governance_proposal
Get Single Proposal Detail
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposalId'], 'properties': {'voter': {'type': 'string', 'description': 'Voter address to look up receipt'}, 'proposalId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Proposal ID (1-indexed)'}}}
get_identity
Get MegaChad Identity
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['addressOrName'], 'properties': {'addressOrName': {'type': 'string', 'description': 'Wallet address (0x...) or .mega name (e.g. "chad.mega" or "chad")'}}}
get_looksmaxx_plan
Get Looksmaxx Plan
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'wallet': {'type': 'string', 'description': 'Wallet address (0x...)'}, 'ethAmount': {'type': 'string', 'description': 'ETH to swap (e.g. "0.5"). Omit if wallet already has enough $MEGACHAD.'}}}
get_looksmaxx_requirements
Get Looksmaxx Requirements
Returns the x402 payment requirements and $MEGACHAD burn requirements for looksmaxxing. Includes step-by-step instructions, contract addresses, and amounts.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_megachad_stats
Get $MEGACHAD Token Stats
Returns current $MEGACHAD token statistics: total supply, circulating supply, tokens burned, and total burn count.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_megaeth_protocols
Get MegaETH Protocol Directory
Returns a curated directory of protocols on MegaETH: DEXes, bridges, payment infra, storage, identity systems. Includes contract addresses, features, and links.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_nft_inventory
Get NFT Inventory + Staking Eligibility
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Wallet address (0x...)'}}}
get_nft_metadata
Get NFT Metadata
Returns ERC-721 metadata for a looksmaxxed NFT including image URL (IPFS or Warren on-chain), attributes, and storage properties.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tokenId'], 'properties': {'tokenId': {'type': 'string', 'description': 'NFT token ID (numeric string)'}}}
get_portfolio
Get MegaETH Portfolio
Get all MegaETH token balances for a wallet: ETH, WETH, $MEGACHAD, USDm. Returns formatted balances with raw values.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Wallet address (0x...)'}}}
get_price
Get $MEGACHAD Price
Returns the current $MEGACHAD price in ETH from Kumbaya DEX, plus the estimated ETH cost to burn 225,000 tokens.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_protocol_registry
Get MEGA Protocol Registry
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_protocol_safety
Get Protocol Safety Status
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_referral_stats
Get Referral Stats
Get referral statistics for a registered agent — total referrals, earnings, reward per burn, and calldata for referred burns.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Agent wallet address (0x...)'}}}
get_staking_position
Get Staking Position (MoggerStaking + JESTERGOONER)
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'Wallet address (0x...) â\x80\x94 optional, gives per-wallet position'}}}
get_swap_quote
Get Swap Quote
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ethAmount': {'type': 'string', 'description': 'Amount of ETH to swap (e.g. "0.1"). Omit for general info.'}}}
get_wallet_info
Get Wallet Info
Check a wallet's ETH balance, $MEGACHAD balance, NFT count, burn eligibility, and early access status.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Ethereum wallet address (0x...)'}}}
list_governance_proposals
List Jestermogger Proposals
List recent Jestermogger governance proposals with state (Pending / Active / Defeated / Succeeded / Queued / Executed / Expired / Vetoed), vote tallies, timing, and per-proposal lookup URLs.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of proposals (default 20)'}}}
register_early_access
Register for Early Access
Register a wallet for MegaChad testnet beta access. Checks on-chain eligibility ($MEGACHAD balance or looksmaxxed NFTs). Returns referral code and access status.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'wallet': {'type': 'string', 'description': 'Ethereum wallet address (0x...)'}, 'twitter': {'type': 'string', 'description': 'X/Twitter handle (optional for agents)'}, 'referralCode': {'type': 'string', 'description': 'Referral code from existing registrant'}}}
register_referral_agent
Register as Referral Agent
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'wallet': {'type': 'string', 'description': 'Agent wallet address (0x...)'}, 'description': {'type': 'string', 'description': 'Agent description (optional)'}, 'mcpEndpoint': {'type': 'string', 'description': 'Agent MCP server URL (optional)'}}}
Added
get_megaeth_protocols
Sept. 17, 2026, 12:45 p.m.
Added
get_agent_index
Sept. 17, 2026, 12:45 p.m.
Added
get_activity_feed
Sept. 17, 2026, 12:45 p.m.
Added
get_protocol_safety
Sept. 17, 2026, 12:45 p.m.
Added
get_nft_inventory
Sept. 17, 2026, 12:45 p.m.
Added
build_veto_tx
Sept. 17, 2026, 12:45 p.m.
Added
build_propose_tx
Sept. 17, 2026, 12:45 p.m.
Added
build_execute_tx
Sept. 17, 2026, 12:45 p.m.
Added
build_queue_tx
Sept. 17, 2026, 12:45 p.m.
Added
get_emission_schedule
Sept. 17, 2026, 12:45 p.m.
Added
build_vote_tx
Sept. 17, 2026, 12:45 p.m.
Added
get_governance_proposal
Sept. 17, 2026, 12:45 p.m.
Added
list_governance_proposals
Sept. 17, 2026, 12:45 p.m.
Added
build_amm_add_liquidity_tx
Sept. 17, 2026, 12:45 p.m.
Added
build_amm_swap_tx
Sept. 17, 2026, 12:45 p.m.
Added
get_amm_quote
Sept. 17, 2026, 12:45 p.m.
Added
build_staking_tx
Sept. 17, 2026, 12:45 p.m.
Added
get_staking_position
Sept. 17, 2026, 12:45 p.m.
Added
get_protocol_registry
Sept. 17, 2026, 12:45 p.m.
Added
get_portfolio
Sept. 17, 2026, 12:45 p.m.
Added
get_identity
Sept. 17, 2026, 12:45 p.m.
Added
cross_chain_looksmaxx
Sept. 17, 2026, 12:45 p.m.
Added
get_bridge_info
Sept. 17, 2026, 12:45 p.m.
Added
chat_with_megachad
Sept. 17, 2026, 12:45 p.m.
Added
get_referral_stats
Sept. 17, 2026, 12:45 p.m.
Added
register_referral_agent
Sept. 17, 2026, 12:45 p.m.
Added
gasless_burn_info
Sept. 17, 2026, 12:45 p.m.
Added
get_looksmaxx_plan
Sept. 17, 2026, 12:45 p.m.
Added
get_wallet_info
Sept. 17, 2026, 12:45 p.m.
Added
get_price
Sept. 17, 2026, 12:45 p.m.