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 (12)
⚪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)"
},
"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#"
}⚪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