@marketmayhem/mcp

MCP serverDev tools

Launch and trade BSC tokens on Market Mayhem. Your own wallet signs; dry run by default; spend caps.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the what can you do tool from @marketmayhem/mcp

Install @marketmayhem/mcp

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user marketmayhem-mcp 'https://marketmayhem.co/api/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://marketmayhem.co/api/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=marketmayhem-mcp&config=eyJ1cmwiOiJodHRwczovL21hcmtldG1heWhlbS5jby9hcGkvbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://marketmayhem.co/api/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add marketmayhem-mcp --url 'https://marketmayhem.co/api/mcp'

    Run it once, then sign in with codex mcp login marketmayhem-mcp if the server asks for an account.

From the project's README

As published by comovis/marketmayhem-mcp in README.md.

Market Mayhem for AI agents: launch and trade BSC tokens through an MCP server.

  • Your wallet signs, locally. The key never leaves this process. Market Mayhem's API builds and simulates each transaction; this server checks it against your limits and signs it.
  • Dry run by default. Until you set MM_LIVE=1, every tool says exactly what it would do and signs nothing.

No install at all? Add https://marketmayhem.co/api/mcp as a connector in Claude, ChatGPT or any MCP client. That hosted server reads and prepares trades; the person confirms each one in their own wallet on marketmayhem.co. This package is for an agent with its own wallet.

Docs: marketmayhem.co/developers · For AIs: marketmayhem.co/llms.txt

Tools

ToolWhat it does
get_settingsThe network, contracts, fees and pair currencies. Read first.
new_launchesTokens launched, newest first. Pass after to get only new ones.
get_tokenOne token: pool, fee tier, pair currency, creator.
quoteWhat a buy or sell would get now, with price impact and fee.
buy / sellTrade, within your caps and allowlist. sell takes amount or percent.
launch_tokenLaunch a token, with an optional first buy split across up to 8 wallets (the dead address burns), and burnPct for the royalty.
tx_statusPending, mined or indexed.
my_referral_earnings / referral_linkEarn a share of the fee on every trade your link brings, for life.

Errors come back as { error, message, fix }, so the agent can correct itself.

Setup

Claude Desktop (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "marketmayhem": {
      "command": "npx",
      "args": ["-y", "@marketmayhem/mcp"],
      "env": {
        "MM_PRIVATE_KEY": "0x… the agent's own wallet",
        "MM_MAX_PER_TX": "BNB:0.05",
        "MM_MAX_PER_DAY": "BNB:0.25"
      }
    }
  }
}

Claude Code: claude mcp add marketmayhem -e MM_PRIVATE_KEY=0x… -- npx -y @marketmayhem/mcp

Settings

VariableDefaultMeaning
MM_LIVEunset (dry run)1 lets the agent send.
MM_PRIVATE_KEY—The agent's own wallet. Use a wallet made for it, holding only what it may spend.
MM_WALLET—Without a key: an address to dry run as. It can never send.
MM_MAX_PER_TXBNB:0.05The most one transaction may spend, per currency (BNB:0.05,USDT:50).
MM_MAX_PER_DAYBNB:0.25The most per UTC day, per currency. A currency with no cap cannot be spent.
MM_ALLOW_TOKENSanyComma-separated tokens the agent may buy or sell.
MM_API_KEY—Your API key: higher limits, and your wallet becomes the default referrer on every trade.
MM_API_URLhttps://marketmayhem.co/api/v1The API.
MM_RPC_URLa public BSC nodeThe node transactions are sent through.
MM_STATE_DIR~/.marketmayhem-mcpWhere today's spend is kept, so a restart can't reset the daily cap.

A sell spends no money, so only the allowlist applies to it. A first-time sale sends the one-time approvals first, then the trade.

Tools it offers (16)

What this server listed when ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.

  • what_can_you_do
  • get_settings
  • new_launches
  • get_token
  • quote
  • prepare_buy
  • prepare_sell
  • prepare_launch
  • intent_status
  • tx_status
  • twap_orders
  • twap_order
  • token_locks
  • token_lock
  • referral_link
  • referral_earnings

Signals

Last commit
Sep 2026

ahel review (caution)

  • S2medium
    demands high-sensitivity credentials

Automated review, not a security audit. Ruleset v1.

Advanced
Delivery
mcp MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
co-marketmayhem-mcp
Source
github.com/comovis/marketmayhem-mcp
Hosted endpoint
https://marketmayhem.co/api/mcp