mcp
Launch and trade BSC tokens on Market Mayhem. Your own wallet signs; dry run by default; spend caps.
Should I use this
Quality & Safety
Findings (4)
- HIGH
- MEDIUMin prepare_launch
- LOWin get_token
- LOWin referral_link
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"@marketmayhem/mcp"
]
}
}
}Runnable packages
0.1.1stdioRemote endpoints
https://marketmayhem.co/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
⚪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",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_settings
The live network (chainId 56 = BSC mainnet, 97 = testnet), contracts, fees and pair currencies.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪new_launches(after, limit)
Tokens launched on Market Mayhem, newest first. Pass `after` (the previous answer's `next`) for only what launched since.
Input Schema
{
"type": "object",
"properties": {
"after": {
"type": "integer"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_token(token)
One token: symbol, name, pool, fee tier, pair currency, creator. Use quote for a price.
Input Schema
{
"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#"
}🟢quote(token, side, amount, slippageBps)
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",
"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_buy(token, amount, slippageBps, referrer)
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",
"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_sell(token, amount, percent, slippageBps, referrer)
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",
"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_launch(name, symbol, marketCapUsd, marketCapPair, pair, ...)
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",
"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)"
},
"shape": {
"anyOf": [
{
"type": "string",
"enum": [
"flat",
"stepped",
"steep"
]
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"fromPct": {
"type": "number",
"minimum": 0
},
"toPct": {
"type": "number",
"exclusiveMinimum": 0
},
"bps": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"fromPct",
"toPct",
"bps"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 4
}
],
"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"
},
"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#"
}⚪intent_status(id)
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",
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{32}$"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪tx_status(hash)
Where a transaction is: pending, failed, confirmed or indexed.
Input Schema
{
"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#"
}⚪twap_orders(owner, token)
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",
"properties": {
"owner": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"token": {
"$ref": "#/properties/owner"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪twap_order(vault)
One TWAP order's history: each slice (amounts, fees, transaction), slots skipped and why, cancels and changes.
Input Schema
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
},
"required": [
"vault"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪token_locks(token, owner)
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",
"properties": {
"token": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"owner": {
"$ref": "#/properties/token"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪token_lock(id)
One token lock: owner, cliff, end, withdrawn, balance, claimable now, and its history.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^\\d+$"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪referral_link(address, path)
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",
"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#"
}⚪referral_earnings(address)
What a wallet has earned as a referrer (instant and lifetime), its links, and any weeks waiting to be claimed.
Input Schema
{
"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#"
}Community
Evidence