MegaChad

io.github.megachadxyzPublished by GitHub account megachadxyzv1.0.0Updated Nov 12, 2026

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

VerifiedStreamable HTTPWeb executableFinanceMedia & DesignAI & ML

Overview

AI-generated overview

MCP server for the MegaChad burn-to-create engine on MegaETH, giving an assistant token, swap, staking, governance and NFT tools plus ready-to-sign…

What you can do
  • Read token and market data: supply, burn counts, price, swap quotes, wallet balances and portfolios
  • Build transaction plans and calldata for swaps, burns, gasless burns, staking, unstaking, claims, liquidity and governance votes
  • Browse burn gallery, burner leaderboard, NFT metadata, identity profiles and protocol registries
  • Check burn requirements, x402 payment terms, bridge options and cross-chain plans from other chains
  • Register wallets for early access or as referral agents and read referral statistics
  • Answer plain-English requests through a chat intent tool
When to use it
Useful when an assistant needs to inspect or act on MegaETH DeFi and NFT activity: quoting swaps, planning burns, checking staking or governance state, or assembling calldata for a user to sign. Also handy for cross-chain plans into MegaETH and for identity or leaderboard lookups.
Requirements
Remote Streamable HTTP endpoint; no packages, environment variables or headers declared. A MegaETH wallet address is needed for wallet-specific tools, and a wallet is required to sign any returned transactions. Network access to the hosted endpoint.
Before you install
Tools return transaction calldata and EIP-712 payloads for real on-chain actions, including burns, swaps, staking and governance votes; signing them spends funds and is irreversible. Burns and x402 flows cost tokens or payments. Referral and early-access registration submit wallet data. Verify contract addresses and amounts before signing.

Installation

In SourceWeft

  1. Open MegaChad in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.megachadxyz%2Fmegachad/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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)

ToolDescription
get_megachad_statsToken supply, circulating supply, burn count
get_price$MEGACHAD price in ETH from Kumbaya DEX
get_swap_quoteSwap quote for ETH → $MEGACHAD with calldata
get_wallet_infoWallet balances, NFT count, burn eligibility
get_portfolioFull MegaETH token portfolio (ETH, WETH, MEGACHAD, USDm)
get_galleryBrowse looksmaxxed burns with IPFS images
get_chadboardBurner leaderboard with reputation scores and .mega names
get_identityResolve wallet or .mega name into unified identity profile
get_nft_metadataERC-721 metadata for looksmaxxed NFTs
get_looksmaxx_requirementsBurn requirements and x402 payment info
get_looksmaxx_planFull transaction plan: swap → burn → tren fund → submit
cross_chain_looksmaxxCross-chain plan from 10+ chains to MegaETH
gasless_burn_infoEIP-712 typed data for gasless meta-transaction burns
get_bridge_infoBridge options for moving assets to MegaETH
get_agent_infoERC-8004 agent registration and reputation data
register_referral_agentRegister as referring agent (earn 11,250 $MEGACHAD per burn)
get_referral_statsReferral count, earnings, and reward info
register_early_accessRegister wallet for beta access
chat_with_megachadNatural language interface for all operations
get_megaeth_protocolsCurated 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

Social & Messaging

  • 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.gitcd mega-chadnpm installcp env.example .env.local  # fill in API keysnpm run dev

Links

Source: README.md at commit 044aaf5

Tools

38

get_megachad_stats

Get $MEGACHAD Token Stats

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

Takes no parameters.

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.

ParametersethAmount

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.

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

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.

ParameterswalletrequiredtwitterreferralCode

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.

ParameterstokenIdrequired

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.

Takes no parameters.

get_wallet_info

Get Wallet Info

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

Parametersaddressrequired

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.

ParameterswalletrequiredethAmount

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.

Parametersaddressrequired

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.

ParameterswalletrequireddescriptionmcpEndpoint

get_referral_stats

Get Referral Stats

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

Parametersaddressrequired

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.

Parameterswalletmessagerequired

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.

Takes no parameters.

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.

ParametersamountwalletreferrersourceChainrequired

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.

ParametersaddressOrNamerequired

get_portfolio

Get MegaETH Portfolio

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

Parametersaddressrequired

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.

Takes no parameters.

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.

Parametersaddress

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.

Parametersvenuerequiredactionrequiredamountaddress

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.

Parametersfromamount

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.

ParametersfromrequiredamountrequiredrecipientrequiredslippageBps

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.

ParametersaddressamountMCrequiredamountMGrequiredrecipientrequired

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.

Parameterslimit

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.

ParametersvoterproposalIdrequired

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.

ParameterssupportrequiredproposalIdrequired

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.

Takes no parameters.

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.

ParametersproposalIdrequired

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.

ParametersproposalIdrequired

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.

Parametersproposer

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.

ParametersvotersupportproposalIdrequired

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.

Parametersaddressrequired

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.

Takes no parameters.

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.

Parameterslimitblocks

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.

Takes no parameters.

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.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.