MCP Server

mcp

co.marketmayhem/mcp
Crypto & Web3 Public & reachable MCP 2025-11-25

What this MCP does

Prepares BSC token launches, buys, and sells for user wallet signing, and provides token quotes, transaction status, and referral information.

get_settings
The live network (chainId 56 = BSC mainnet, 97 = testnet), contracts, fees and pair currencies.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_token
One token: symbol, name, pool, fee tier, pair currency, creator. Use quote for a price.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}
intent_status
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).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}}, 'additionalProperties': False}
new_launches
Tokens launched on Market Mayhem, newest first. Pass `after` (the previous answer's `next`) for only what launched since.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'after': {'type': 'integer'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}}, 'additionalProperties': False}
prepare_buy
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token', 'amount'], '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'}, 'referrer': {'$ref': '#/properties/token', 'description': 'a registered referrer (e.g. the app or agent that brought them) earns the referral share'}, 'slippageBps': {'type': 'integer', 'maximum': 5000, 'minimum': 1}}, 'additionalProperties': False}
prepare_launch
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'symbol', 'image'], 'properties': {'x': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'pair': {'type': 'string', 'description': '"BNB" (default), a listed symbol like "USDT", or any BEP20 address'}, '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'}, 'shape': {'anyOf': [{'enum': ['flat', 'stepped', 'steep'], 'type': 'string'}, {'type': 'array', 'items': {'type': 'object', 'required': ['fromPct', 'toPct', 'bps'], 'properties': {'bps': {'type': 'integer', 'exclusiveMinimum': 0}, 'toPct': {'type': 'number', 'exclusiveMinimum': 0}, 'fromPct': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 4, 'minItems': 1}], 'description': 'how the supply is laid out: "flat" (default), "stepped", "steep", or 1 to 4 custom ranges { fromPct, toPct, bps } measured from the top of the platform curve, bps adding to 10000'}, 'supply': {'$ref': '#/properties/marketCapUsd', 'description': 'whole tokens, default 1000000000'}, 'symbol': {'type': 'string', 'maxLength': 32, 'minLength': 1}, '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"}, 'burnPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'share of the creator royalty that buys back and burns, for ever (100 = all)'}, 'website': {'type': 'string', 'format': 'uri'}, 'firstBuy': {'$ref': '#/properties/marketCapUsd', 'description': 'a first buy in the pair currency, inside the launch'}, 'referrer': {'$ref': '#/properties/firstBuyTo/items/properties/wallet'}, 'telegram': {'type': 'string', 'format': 'uri'}, 'royaltyTo': {'$ref': '#/properties/firstBuyTo/items/properties/wallet', 'description': 'send the royalty to another wallet (only with burnPct 0)'}, 'firstBuyTo': {'type': 'array', 'items': {'type': 'object', 'required': ['wallet', 'pct'], 'properties': {'pct': {'type': 'number', 'exclusiveMinimum': 0}, 'wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}, 'maxItems': 8, 'minItems': 1}, 'description': {'type': 'string', 'maxLength': 1000}, 'marketCapUsd': {'type': 'string', 'pattern': '^\\d+(\\.\\d+)?$', 'description': 'the opening market cap in dollars'}, 'marketCapPair': {'$ref': '#/properties/marketCapUsd', 'description': 'or in the pair currency'}}, 'additionalProperties': False}
prepare_sell
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d+(\\.\\d+)?$'}, 'percent': {'type': 'number', 'maximum': 100, 'minimum': 0.01}, 'referrer': {'$ref': '#/properties/token'}, 'slippageBps': {'type': 'integer', 'maximum': 5000, 'minimum': 1}}, 'additionalProperties': False}
quote
What a buy or a sale would get right now: amounts, minimum after slippage, site fee and price impact. Sends nothing.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token', 'side', 'amount'], 'properties': {'side': {'enum': ['buy', 'sell'], 'type': 'string'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d+(\\.\\d+)?$', 'description': 'buy: pair currency to spend (e.g. BNB); sell: whole tokens'}, 'slippageBps': {'type': 'integer', 'maximum': 5000, 'minimum': 1}}, 'additionalProperties': False}
referral_earnings
What a wallet has earned as a referrer (instant and lifetime), its links, and any weeks waiting to be claimed.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}
referral_link
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'path': {'type': 'string', 'description': 'a page of the site, e.g. /t/<token>'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}
token_lock
One token lock: owner, cliff, end, withdrawn, balance, claimable now, and its history.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^\\d+$'}}, 'additionalProperties': False}
token_locks
Token locks by token or by wallet, with live balances. By token it also says how much of the supply is locked: only locks paid for by their own owner and holding at least 0.01% count, because anyone can lock dust or lock for someone else.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'$ref': '#/properties/token'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}
twap_order
One TWAP order's history: each slice (amounts, fees, transaction), slots skipped and why, cancels and changes.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault'], 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}
twap_orders
TWAP orders (a buy or sale spread over time in slices) by wallet or by token, newest first, with progress and whether the keeper has paused one (price past its limit, needs gas).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'token': {'$ref': '#/properties/owner'}}, 'additionalProperties': False}
tx_status
Where a transaction is: pending, failed, confirmed or indexed.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$'}}, 'additionalProperties': False}
what_can_you_do
What this server can and cannot do, and how a trade or launch gets signed. Call this if unsure.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Changed
prepare_launch
Oct. 1, 2026, 2:42 a.m.
Added
token_lock
Sept. 29, 2026, 2:48 a.m.
Added
token_locks
Sept. 29, 2026, 2:48 a.m.
Added
twap_order
Sept. 29, 2026, 2:48 a.m.
Added
twap_orders
Sept. 29, 2026, 2:48 a.m.
Added
referral_earnings
Sept. 27, 2026, 2:40 a.m.
Added
referral_link
Sept. 27, 2026, 2:40 a.m.
Added
tx_status
Sept. 27, 2026, 2:40 a.m.
Added
intent_status
Sept. 27, 2026, 2:40 a.m.
Added
prepare_launch
Sept. 27, 2026, 2:40 a.m.
Added
prepare_sell
Sept. 27, 2026, 2:40 a.m.
Added
prepare_buy
Sept. 27, 2026, 2:40 a.m.
Added
quote
Sept. 27, 2026, 2:40 a.m.
Added
get_token
Sept. 27, 2026, 2:40 a.m.
Added
new_launches
Sept. 27, 2026, 2:40 a.m.
Added
get_settings
Sept. 27, 2026, 2:40 a.m.
Added
what_can_you_do
Sept. 27, 2026, 2:40 a.m.