mcp

What this server can and cannot do, and how a trade or launch gets signed. Call this if unsure.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The live network (chainId 56 = BSC mainnet, 97 = testnet), contracts, fees and pair currencies.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tokens launched on Market Mayhem, newest first. Pass `after` (the previous answer's `next`) for only what launched since.

{
  "type": "object",
  "properties": {
    "after": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One token: symbol, name, pool, fee tier, pair currency, creator. Use quote for a price.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What a buy or a sale would get right now: amounts, minimum after slippage, site fee and price impact. Sends nothing.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$",
      "description": "buy: pair currency to spend (e.g. BNB); sell: whole tokens"
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "token",
    "side",
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare a buy for the person to sign on marketmayhem.co. Returns a link and a summary; nothing is bought until they confirm in their own wallet.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$",
      "description": "how much of the pair currency to spend, e.g. \"0.1\" BNB"
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "referrer": {
      "$ref": "#/properties/token",
      "description": "a registered referrer (e.g. the app or agent that brought them) earns the referral share"
    }
  },
  "required": [
    "token",
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare a sale for the person to sign on marketmayhem.co: `amount` in whole tokens or `percent` of what their wallet holds. Nothing is sold until they confirm.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$"
    },
    "percent": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 100
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "referrer": {
      "$ref": "#/properties/token"
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Prepare a token launch for the person to sign on marketmayhem.co. Needs a name, a ticker, an opening market cap and a logo link. Optional first buy in the same transaction (so nobody buys before them), split across up to 8 wallets; the dead address 0x000000000000000000000000000000000000dEaD burns that part. burnPct sends the creator royalty to buy back and burn. Nothing launches until they confirm.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "marketCapUsd": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$",
      "description": "the opening market cap in dollars"
    },
    "marketCapPair": {
      "$ref": "#/properties/marketCapUsd",
      "description": "or in the pair currency"
    },
    "pair": {
      "type": "string",
      "description": "\"BNB\" (default), a listed symbol like \"USDT\", or any BEP20 address"
    },
    "supply": {
      "$ref": "#/properties/marketCapUsd",
      "description": "whole tokens, default 1000000000"
    },
    "firstBuy": {
      "$ref": "#/properties/marketCapUsd",
      "description": "a first buy in the pair currency, inside the launch"
    },
    "firstBuyTo": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "wallet": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "pct": {
            "type": "number",
            "exclusiveMinimum": 0
          }
        },
        "required": [
          "wallet",
          "pct"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 8
    },
    "burnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "share of the creator royalty that buys back and burns, for ever (100 = all)"
    },
    "royaltyTo": {
      "$ref": "#/properties/firstBuyTo/items/properties/wallet",
      "description": "send the royalty to another wallet (only with burnPct 0)"
    },
    "image": {
      "type": "string",
      "format": "uri",
      "description": "an https:// link to the logo (PNG, JPG, GIF or WebP, up to 5 MB). Required: ask the person for one"
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "website": {
      "type": "string",
      "format": "uri"
    },
    "x": {
      "type": "string",
      "format": "uri"
    },
    "telegram": {
      "type": "string",
      "format": "uri"
    },
    "wallet": {
      "$ref": "#/properties/firstBuyTo/items/properties/wallet",
      "description": "the person's wallet, if they told you; the sign page checks it is the one that signs"
    },
    "referrer": {
      "$ref": "#/properties/firstBuyTo/items/properties/wallet"
    }
  },
  "required": [
    "name",
    "symbol",
    "image"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Whether a prepared request was signed: open (waiting for the person), sent (with the transaction and whether it is confirmed), or expired (prepare a new one).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{32}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Where a transaction is: pending, failed, confirmed or indexed.

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "hash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A referral link for a wallet: people who trade through it pay that wallet a share of the fee, for life. The wallet must be registered or a creator to earn.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "path": {
      "type": "string",
      "description": "a page of the site, e.g. /t/<token>"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What a wallet has earned as a referrer (instant and lifetime), its links, and any weeks waiting to be claimed.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}