Back

Dead-Coin Desk MCP

Tool specifications — The desk tools below are exposed through the main EventTrader MCP server. Both are read tools and work unauthenticated.

The Model Context Protocol (MCP) server exposes the Dead-Coin Buyback Desk to LLM clients (Claude Desktop, Claude Code, MCP-compatible agents). Ask your AI assistant what a stranded token position is worth, whether it prices as a real bid or a tax-loss disposal, and how to accept the quote — all through natural language.

REST API Python SDK MCP Tools Product Page

Server Endpoint

https://cymetica.com/mcp/v1

EventTrader exposes a single MCP surface — the same endpoint serves arena, exchange, the prediction pools, and the Dead-Coin Desk. The tools below filter to the desk when called.

Discovery: GET /.well-known/mcp.json · Tools: GET /mcp/v1/tools · Register: POST /mcp/v1/register

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "eventtrader": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cymetica.com/mcp/v1"]
    }
  }
}

Tools

Tool	Args	Description
`get_deadcoin_quote`	`contract_address, chain?, amount_tokens?`	Firm USDC bid for a dead/delisted token position, priced from live DEX data across all surviving pools. Returns tier (`LIQUID` / `DUST` / `DECLINED`), `bid_usdc`, the pricing evidence, and a `quote_id` valid ~15 minutes. Omit `amount_tokens` for a per-token preview.
`get_deadcoin_desk_info`	—	How the desk works: supported chains, tiers, the 20–40% liquidity-scaled discount model, quote TTL, and the quote→reserve→settle flow.

Authentication

Both tools are read-only and work unauthenticated. Reserving a quote moves money, so it is not exposed as an MCP tool — accept a quote_id via the authenticated REST endpoint POST /api/v1/deadcoins/reserve (JWT) or the Python SDK.

Example LLM Prompts

"What would EventTrader pay for 1.5M of this token: 0x1234…dead?"
"Is this contract worth anything on any chain, or is it dust?"
"Quote my SQUID bag on BSC and tell me the discount you'd take."
"How does the dead-coin desk price tax-loss disposals?"
"Which chains does the dead-coin desk support?"

Tool Reference

get_deadcoin_quote

{
  "name": "get_deadcoin_quote",
  "description": "Firm USDC bid for a dead/delisted token position from the Dead-Coin Buyback Desk, priced from live DEX data. Returns tier, bid_usdc, discount_pct, pricing evidence, quote_id (~15 min TTL).",
  "inputSchema": {"type":"object","properties":{
    "contract_address":{"type":"string","description":"Token contract (0x…) or Solana mint"},
    "chain":{"type":"string","enum":["auto","ethereum","base","bsc","polygon","arbitrum","avalanche","optimism","solana"],"default":"auto"},
    "amount_tokens":{"type":"string","description":"Position size in tokens (omit for a preview quote)"}
  },"required":["contract_address"]}
}

get_deadcoin_desk_info

{
  "name": "get_deadcoin_desk_info",
  "description": "How the Dead-Coin Buyback Desk works: supported chains, pricing tiers (LIQUID / DUST tax-loss disposal / DECLINED), discount model, quote TTL, and the quote->reserve->settle flow.",
  "inputSchema": {"type":"object","properties":{}}
}

Limits

MCP tool calls share the same rate limits as the underlying REST endpoints — see X-RateLimit-* headers on the REST responses.

EventTrader