{
  "markdown": "# MegaChad — MCP Server & Burn-to-Create Engine on MegaETH\n\nMegaChad is a **Model Context Protocol (MCP) server** and burn-to-create looksmaxxing engine on [MegaETH](https://megaeth.com). It exposes **20 MCP tools** that let AI agents interact with DeFi, NFTs, identity, and cross-chain operations on the MegaETH real-time blockchain.\n\n## MCP Server\n\n**Endpoint:** `https://megachad.xyz/api/mcp` (Streamable HTTP)\n\nConnect any MCP-compatible client (Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"megachad\": {\n      \"url\": \"https://megachad.xyz/api/mcp\"\n    }\n  }\n}\n```\n\n### MCP Tools (20)\n\n| Tool | Description |\n|------|-------------|\n| `get_megachad_stats` | Token supply, circulating supply, burn count |\n| `get_price` | $MEGACHAD price in ETH from Kumbaya DEX |\n| `get_swap_quote` | Swap quote for ETH → $MEGACHAD with calldata |\n| `get_wallet_info` | Wallet balances, NFT count, burn eligibility |\n| `get_portfolio` | Full MegaETH token portfolio (ETH, WETH, MEGACHAD, USDm) |\n| `get_gallery` | Browse looksmaxxed burns with IPFS images |\n| `get_chadboard` | Burner leaderboard with reputation scores and .mega names |\n| `get_identity` | Resolve wallet or .mega name into unified identity profile |\n| `get_nft_metadata` | ERC-721 metadata for looksmaxxed NFTs |\n| `get_looksmaxx_requirements` | Burn requirements and x402 payment info |\n| `get_looksmaxx_plan` | Full transaction plan: swap → burn → tren fund → submit |\n| `cross_chain_looksmaxx` | Cross-chain plan from 10+ chains to MegaETH |\n| `gasless_burn_info` | EIP-712 typed data for gasless meta-transaction burns |\n| `get_bridge_info` | Bridge options for moving assets to MegaETH |\n| `get_agent_info` | ERC-8004 agent registration and reputation data |\n| `register_referral_agent` | Register as referring agent (earn 11,250 $MEGACHAD per burn) |\n| `get_referral_stats` | Referral count, earnings, and reward info |\n| `register_early_access` | Register wallet for beta access |\n| `chat_with_megachad` | Natural language interface for all operations |\n| `get_megaeth_protocols` | Curated MegaETH protocol directory |\n\n## What It Does\n\n- **Burn-to-Create:** Burn 225,000 $MEGACHAD tokens to generate AI-enhanced looksmaxxed portraits and mint NFTs on MegaETH\n- **Cross-Chain:** Bridge + swap + burn from Ethereum, Base, Arbitrum, Optimism, Polygon, and 5 more chains\n- **Identity Layer:** Unified profiles from on-chain data, MegaNames (.mega domains), burn history, reputation scores\n- **Chadboard & Tiers:** Leaderboard ranked by burns — Normie (0) → Mewer (1+) → Bonesmasher (3+) → Chad (10+) → Gigachad (25+)\n- **ChadChat:** Burn-gated real-time messaging for holders (Mewer tier+), powered by Ably\n- **Agent Referrals:** On-chain referral economy — agents earn 11,250 $MEGACHAD (5%) per referred burn\n- **MEGA Protocol Governance:** $MEGAGOONER token (50M cap, 225-week quadratic emission) with Framemogger, MoggerStaking, JESTERGOONER staking, and Jestermogger governance voting\n- **x402 Payments:** HTTP 402 payment protocol via Meridian for API monetization\n- **ERC-8004:** Registered on-chain agent (#12408) with reputation tracking\n- **Telegram Alerts:** Real-time burn/mint notifications via [@megachads](https://t.me/megachads)\n- **Natural Language:** NLP transaction engine — type plain English, get structured calldata\n- **Gasless Burns:** EIP-712 meta-transactions via relayer — no gas fees needed\n- **MegaETH Portal:** Portfolio viewer, protocol directory, live network stats, NLP command bar\n- **Farcaster Frames:** Frame-based burn gallery, leaderboard, and price discovery\n- **Analytics:** Per-endpoint and per-MCP-tool usage tracking\n\n## API Endpoints (36)\n\n### Core\n- `GET /api/stats` — Token supply, burn count\n- `GET /api/price` — Current price + burn cost\n- `GET /api/wallet?address=0x` — Balance + eligibility\n- `GET /api/gallery?limit=20` — Recent burns\n- `GET /api/chadboard` — Leaderboard\n\n### Burn & Generation\n- `GET|POST /api/x402/looksmaxx` — x402-gated looksmaxx\n- `GET /api/x402/quote?ethAmount=0.1` — Swap quote\n- `POST /api/generate` — Direct burn + generate\n- `GET|POST /api/gasless/burn` — EIP-712 gasless burn\n- `POST /api/warren/deploy` — Warren on-chain storage\n- `GET /api/metadata/{tokenId}` — NFT metadata\n\n### Agent & NLP\n- `POST /api/agent/chat` — Natural language transactions\n- `GET /api/agent/looksmaxx?wallet=0x` — Full burn plan\n- `GET /api/agent/info` — ERC-8004 identity\n- `GET|POST /api/agent/register` — Agent registration\n- `GET /api/agent/referrals?address=0x` — Referral stats\n\n### Cross-Chain & Bridge\n- `GET /api/cross-chain/intent?sourceChain=base` — Cross-chain plan\n- `GET /api/cross-chain/status?id=cc_` — Intent tracking\n- `GET /api/bridge` — Bridge infrastructure\n\n### Identity & Portal\n- `GET /api/identity/{address}` — Unified identity profile\n- `GET /api/portal/tokens?address=0x` — MegaETH portfolio\n- `GET /api/portal/protocols` — Protocol directory\n\n### Social & Messaging\n- `POST /api/chat/auth` — ChadChat Ably auth token\n- `GET|POST /api/chat/messages` — Chat message storage\n- `GET|POST /api/chat/name` — Display name management\n- `POST /api/telegram` — Telegram bot webhook\n- `POST /api/telegram/alerts` — Burn/mint notifications\n- `GET /api/frame` — Farcaster frame navigation\n\n### Infrastructure\n- `GET /api/events` — SSE event stream\n- `GET /api/analytics` — Usage tracking\n- `POST /api/early/register` — Beta access registration\n\n## Tech Stack\n\n- **Next.js 14** (App Router) on Vercel\n- **MegaETH** (Chain ID 4326, ~250ms blocks, 100k+ TPS)\n- **Wagmi + viem** for wallet interactions\n- **mcp-handler** for MCP server implementation\n- **Kumbaya DEX** for swaps\n- **Warren Protocol** for on-chain image storage\n- **Ably** for real-time ChadChat messaging\n- **Upstash Redis** for metadata caching\n- **Pinata** for IPFS storage\n- **Replicate** for AI generation (Flux 2 Max)\n- **Meridian** for x402 payments (USDm)\n\n## Setup\n\n```bash\ngit clone https://github.com/megachadxyz/mega-chad.git\ncd mega-chad\nnpm install\ncp env.example .env.local  # fill in API keys\nnpm run dev\n```\n\n## Links\n\n- **App:** [megachad.xyz](https://megachad.xyz)\n- **MCP Endpoint:** [megachad.xyz/api/mcp](https://megachad.xyz/api/mcp)\n- **Repo:** [github.com/megachadxyz/mega-chad](https://github.com/megachadxyz/mega-chad)\n- **X:** [@megachadxyz](https://x.com/megachadxyz)\n",
  "bytes": 6306,
  "sha": "e6faea169d76565308a1559308435d27c96ec1220a56facb13f06140ea3862e6",
  "repo_slug": "megachadxyz/mega-chad",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_megachadxyz_megachad_64215a52/readme"
}