English Français العربية

co.marketmayhem/mcp

Official registry Finance and payments

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http co-marketmayhem-mcp 'https://marketmayhem.co/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "co-marketmayhem-mcp": {
            "type": "http",
            "url": "https://marketmayhem.co/api/mcp"
        }
    }
}
NPM package @marketmayhem/mcp
Claude Code 
claude mcp add co-marketmayhem-mcp -e 'MM_PRIVATE_KEY=<your mm_private_key>' -e 'MM_LIVE=<MM_LIVE>' -e 'MM_MAX_PER_TX=<MM_MAX_PER_TX>' -e 'MM_MAX_PER_DAY=<MM_MAX_PER_DAY>' -e 'MM_ALLOW_TOKENS=<MM_ALLOW_TOKENS>' -e 'MM_API_KEY=<your mm_api_key>' -- npx -y @marketmayhem/mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "co-marketmayhem-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@marketmayhem/mcp@0.1.1"
            ],
            "env": {
                "MM_PRIVATE_KEY": "<your mm_private_key>",
                "MM_LIVE": "<MM_LIVE>",
                "MM_MAX_PER_TX": "<MM_MAX_PER_TX>",
                "MM_MAX_PER_DAY": "<MM_MAX_PER_DAY>",
                "MM_ALLOW_TOKENS": "<MM_ALLOW_TOKENS>",
                "MM_API_KEY": "<your mm_api_key>"
            }
        }
    }
}

Environment variables

  • MM_PRIVATE_KEY secret The agent's own wallet key. Signs locally; never sent anywhere. Unset: read-only.
  • MM_LIVE Set to 1 to let the agent send transactions. Unset: dry run.
  • MM_MAX_PER_TX Most one transaction may spend, per currency, e.g. BNB:0.05
  • MM_MAX_PER_DAY Most per UTC day, per currency, e.g. BNB:0.25
  • MM_ALLOW_TOKENS Comma-separated token addresses the agent may trade. Unset: any.
  • MM_API_KEY secret Optional Market Mayhem API key: higher limits, and you become the default referrer.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @marketmayhem/mcp
  2. Tools
  3. Setup
  4. Settings

@marketmayhem/mcp

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.

Frequently asked questions

What is co.marketmayhem/mcp?

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

How do I install co.marketmayhem/mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http co-marketmayhem-mcp 'https://marketmayhem.co/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does co.marketmayhem/mcp need an API key?

Yes. It expects MM_PRIVATE_KEY, MM_API_KEY, which you set in its configuration.

Is co.marketmayhem/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains co.marketmayhem/mcp?

It is published by Comovis. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.