io.github.megachadxyz/megachad

Official38 tools

by megachadxyz · TypeScript

MegaChad

Burn-to-create looksmaxxing engine on MegaETH. 14 MCP tools for DeFi, NFTs, and burns.

14 MCP tools for DeFi and NFT operations on MegaETH blockchain.

Captured live from the server via tools/list.

get_megachad_stats

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

No parameters.

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.

Parameters (1)

ethAmountstring
Amount of ETH to swap (e.g. "0.1"). Omit for general info.

get_looksmaxx_requirements

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

No parameters.

get_gallery

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

Parameters (2)

limitinteger
Number of results (default 20, max 50)
offsetinteger
Pagination offset (default 0)

get_chadboard

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

No parameters.

get_agent_info

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

No parameters.

register_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.

Parameters (3)

walletstringrequired
Ethereum wallet address (0x...)
twitterstring
X/Twitter handle (optional for agents)
referralCodestring
Referral code from existing registrant

get_nft_metadata

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

Parameters (1)

tokenIdstringrequired
NFT token ID (numeric string)

get_price

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

No parameters.

get_wallet_info

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

Parameters (1)

addressstringrequired
Ethereum wallet address (0x...)

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.

Parameters (2)

walletstringrequired
Wallet address (0x...)
ethAmountstring
ETH to swap (e.g. "0.5"). Omit if wallet already has enough $MEGACHAD.

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.

Parameters (1)

addressstringrequired
Wallet address (0x...)

register_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.

Parameters (3)

walletstringrequired
Agent wallet address (0x...)
mcpEndpointstring
Agent MCP server URL (optional)
descriptionstring
Agent description (optional)

get_referral_stats

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

Parameters (1)

addressstringrequired
Agent wallet address (0x...)

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.

Parameters (2)

messagestringrequired
Natural language query (e.g. "What is the current MEGACHAD price?")
walletstring
Wallet address for context (0x...). Optional.

get_bridge_info

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

No parameters.

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.

Parameters (4)

sourceChainstringrequired
Source chain name (e.g. "base", "arbitrum", "ethereum")
walletstring
Wallet address for pre-built calldata (0x...)
amountstring
ETH amount to bridge (e.g. "0.15")
referrerstring
Referrer agent address for 5% commission (0x...)

get_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.

Parameters (1)

addressOrNamestringrequired
Wallet address (0x...) or .mega name (e.g. "chad.mega" or "chad")

get_portfolio

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

Parameters (1)

addressstringrequired
Wallet address (0x...)

get_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.

No parameters.

get_staking_position

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.

Parameters (1)

addressstring
Wallet address (0x...) — optional, gives per-wallet position

build_staking_tx

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.

Parameters (4)

actionstringrequired
Which action to build
venuestringrequired
mogger = MoggerStaking (MEGACHAD), jester = JESTERGOONER V4 (LP)
amountstring
Amount in human units (e.g. "1000"). Required for stake/unstake.
addressstring
Wallet address — used to skip approve if allowance is sufficient

get_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.

Parameters (2)

fromstring
Input token: MC (MEGACHAD) or MG (MEGAGOONER)
amountstring
Input amount in human units (e.g. "1000")

build_amm_swap_tx

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.

Parameters (4)

fromstringrequired
Input token
amountstringrequired
Input amount in human units (e.g. "1000")
recipientstringrequired
Receive address (0x...)
slippageBpsinteger
Slippage tolerance in bps (default 200 = 2%)

build_amm_add_liquidity_tx

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.

Parameters (4)

amountMCstringrequired
MEGACHAD amount in human units
amountMGstringrequired
MEGAGOONER amount in human units
recipientstringrequired
LP token recipient (0x...)
addressstring
Sender address — used to skip approve steps if allowance is sufficient

list_governance_proposals

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

Parameters (1)

limitinteger
Number of proposals (default 20)

get_governance_proposal

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.

Parameters (2)

proposalIdintegerrequired
Proposal ID (1-indexed)
voterstring
Voter address to look up receipt

build_vote_tx

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

Parameters (2)

proposalIdintegerrequired
Proposal ID
supportstringrequired
Vote direction

get_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.

No parameters.

build_queue_tx

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

Parameters (1)

proposalIdintegerrequired
Proposal ID (1-indexed)

build_execute_tx

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

Parameters (1)

proposalIdintegerrequired
Proposal ID

build_propose_tx

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.

Parameters (1)

proposerstring
Proposer wallet address (0x...) — required for eligibility check

build_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.

Parameters (3)

proposalIdintegerrequired
Proposal ID
supportstring
yes = veto, no = defend (default yes)
voterstring
Voter wallet address (0x...) — checks council-membership status

get_nft_inventory

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.

Parameters (1)

addressstringrequired
Wallet address (0x...)

get_protocol_safety

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.

No parameters.

get_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.

Parameters (2)

limitinteger
Max events to return (default 50, max 200)
blocksinteger
Block window to scan (default 2000)

get_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.

No parameters.

get_megaeth_protocols

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

No parameters.

README.md6 KBView on GitHub

MegaChad — MCP Server & Burn-to-Create Engine on MegaETH

MegaChad is a Model Context Protocol (MCP) server and burn-to-create looksmaxxing engine on MegaETH. It exposes 20 MCP tools that let AI agents interact with DeFi, NFTs, identity, and cross-chain operations on the MegaETH real-time blockchain.

MCP Server

Endpoint: https://megachad.xyz/api/mcp (Streamable HTTP)

Connect any MCP-compatible client (Claude Desktop, Cursor, etc.):

json

{
  "mcpServers": {
    "megachad": {
      "url": "https://megachad.xyz/api/mcp"
    }
  }
}

MCP Tools (20)

Tool	Description
`get_megachad_stats`	Token supply, circulating supply, burn count
`get_price`	$MEGACHAD price in ETH from Kumbaya DEX
`get_swap_quote`	Swap quote for ETH → $MEGACHAD with calldata
`get_wallet_info`	Wallet balances, NFT count, burn eligibility
`get_portfolio`	Full MegaETH token portfolio (ETH, WETH, MEGACHAD, USDm)
`get_gallery`	Browse looksmaxxed burns with IPFS images
`get_chadboard`	Burner leaderboard with reputation scores and .mega names
`get_identity`	Resolve wallet or .mega name into unified identity profile
`get_nft_metadata`	ERC-721 metadata for looksmaxxed NFTs
`get_looksmaxx_requirements`	Burn requirements and x402 payment info
`get_looksmaxx_plan`	Full transaction plan: swap → burn → tren fund → submit
`cross_chain_looksmaxx`	Cross-chain plan from 10+ chains to MegaETH
`gasless_burn_info`	EIP-712 typed data for gasless meta-transaction burns
`get_bridge_info`	Bridge options for moving assets to MegaETH
`get_agent_info`	ERC-8004 agent registration and reputation data
`register_referral_agent`	Register as referring agent (earn 11,250 $MEGACHAD per burn)
`get_referral_stats`	Referral count, earnings, and reward info
`register_early_access`	Register wallet for beta access
`chat_with_megachad`	Natural language interface for all operations
`get_megaeth_protocols`	Curated MegaETH protocol directory

What It Does

Burn-to-Create: Burn 225,000 $MEGACHAD tokens to generate AI-enhanced looksmaxxed portraits and mint NFTs on MegaETH
Cross-Chain: Bridge + swap + burn from Ethereum, Base, Arbitrum, Optimism, Polygon, and 5 more chains
Identity Layer: Unified profiles from on-chain data, MegaNames (.mega domains), burn history, reputation scores
Chadboard & Tiers: Leaderboard ranked by burns — Normie (0) → Mewer (1+) → Bonesmasher (3+) → Chad (10+) → Gigachad (25+)
ChadChat: Burn-gated real-time messaging for holders (Mewer tier+), powered by Ably
Agent Referrals: On-chain referral economy — agents earn 11,250 $MEGACHAD (5%) per referred burn
MEGA Protocol Governance: $MEGAGOONER token (50M cap, 225-week quadratic emission) with Framemogger, MoggerStaking, JESTERGOONER staking, and Jestermogger governance voting
x402 Payments: HTTP 402 payment protocol via Meridian for API monetization
ERC-8004: Registered on-chain agent (#12408) with reputation tracking
Telegram Alerts: Real-time burn/mint notifications via @megachads
Natural Language: NLP transaction engine — type plain English, get structured calldata
Gasless Burns: EIP-712 meta-transactions via relayer — no gas fees needed
MegaETH Portal: Portfolio viewer, protocol directory, live network stats, NLP command bar
Farcaster Frames: Frame-based burn gallery, leaderboard, and price discovery
Analytics: Per-endpoint and per-MCP-tool usage tracking

API Endpoints (36)

Core

GET /api/stats — Token supply, burn count
GET /api/price — Current price + burn cost
GET /api/wallet?address=0x — Balance + eligibility
GET /api/gallery?limit=20 — Recent burns
GET /api/chadboard — Leaderboard

Burn & Generation

GET|POST /api/x402/looksmaxx — x402-gated looksmaxx
GET /api/x402/quote?ethAmount=0.1 — Swap quote
POST /api/generate — Direct burn + generate
GET|POST /api/gasless/burn — EIP-712 gasless burn
POST /api/warren/deploy — Warren on-chain storage
GET /api/metadata/{tokenId} — NFT metadata

Agent & NLP

POST /api/agent/chat — Natural language transactions
GET /api/agent/looksmaxx?wallet=0x — Full burn plan
GET /api/agent/info — ERC-8004 identity
GET|POST /api/agent/register — Agent registration
GET /api/agent/referrals?address=0x — Referral stats

Cross-Chain & Bridge

GET /api/cross-chain/intent?sourceChain=base — Cross-chain plan
GET /api/cross-chain/status?id=cc_ — Intent tracking
GET /api/bridge — Bridge infrastructure

Identity & Portal

GET /api/identity/{address} — Unified identity profile
GET /api/portal/tokens?address=0x — MegaETH portfolio
GET /api/portal/protocols — Protocol directory

POST /api/chat/auth — ChadChat Ably auth token
GET|POST /api/chat/messages — Chat message storage
GET|POST /api/chat/name — Display name management
POST /api/telegram — Telegram bot webhook
POST /api/telegram/alerts — Burn/mint notifications
GET /api/frame — Farcaster frame navigation

Infrastructure

GET /api/events — SSE event stream
GET /api/analytics — Usage tracking
POST /api/early/register — Beta access registration

Tech Stack

Next.js 14 (App Router) on Vercel
MegaETH (Chain ID 4326, ~250ms blocks, 100k+ TPS)
Wagmi + viem for wallet interactions
mcp-handler for MCP server implementation
Kumbaya DEX for swaps
Warren Protocol for on-chain image storage
Ably for real-time ChadChat messaging
Upstash Redis for metadata caching
Pinata for IPFS storage
Replicate for AI generation (Flux 2 Max)
Meridian for x402 payments (USDm)

Setup

bash

git clone https://github.com/megachadxyz/mega-chad.git
cd mega-chad
npm install
cp env.example .env.local  # fill in API keys
npm run dev

Install

claude_desktop_config.json

{
  "mcpServers": {
    "megachad": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://megachad.xyz/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

get_megachad_stats

get_swap_quote

get_looksmaxx_requirements

get_gallery

get_chadboard

get_agent_info

register_early_access

get_nft_metadata

get_price

get_wallet_info

get_looksmaxx_plan

gasless_burn_info

register_referral_agent

get_referral_stats

chat_with_megachad

get_bridge_info

cross_chain_looksmaxx

get_identity

get_portfolio

get_protocol_registry

get_staking_position

build_staking_tx

get_amm_quote

build_amm_swap_tx

build_amm_add_liquidity_tx

list_governance_proposals

get_governance_proposal

build_vote_tx

get_emission_schedule

build_queue_tx

build_execute_tx

build_propose_tx

build_veto_tx

get_nft_inventory

get_protocol_safety

get_activity_feed

get_agent_index

get_megaeth_protocols

MegaChad — MCP Server & Burn-to-Create Engine on MegaETH

MCP Server

MCP Tools (20)

What It Does

API Endpoints (36)

Core

Burn & Generation

Agent & NLP

Cross-Chain & Bridge

Identity & Portal

Social & Messaging

Infrastructure

Tech Stack

Setup

Links

Install