all scenarios

Enormous tool description

huge-description · Tools — listing

Endpoint (Streamable HTTP)
https://chaos-mcp.thomascdnns.com/s/huge-description/mcp
On the wire — recorded from a real request
your clientchaos-mcp01initializePOST /s/huge-description/mcp200 OK · application/json · 6 ms"jsonrpc""2.0""id"1"result""protocolVersion""2024-11-05""capabilities""tools""serverInfo""name""chaos-mcp/huge-description""version""1.0.0""instructions""chaos-mcp scenario: huge-description — Enormous tool description"02tools/listPOST /s/huge-description/mcp200 OK · application/json · 3 ms{"jsonrpc": "2.0", "id": 2, "result": {"tools": [{"name": "echo", "description": "Echo back the provided message.", "inputSchema": {"type": "object", "properties": {"message": {"type": "string", "description": "Text to echo"}}, "required": ["message"]}}, {"name": "add", "description": "Add two numbers and return the sum.", "inputSchema": {"type": "object", "properties": {"a": {"type": "number"}, "b": {"type": "number"}}, "required": ["a", "b"]}}, {"name": "current_time", "description": "Return the current server time in RFC3339.", "inputSchema": {"type": "object", "properties": {"timezone": {"type": "string", "description": "IANA timezone, default UTC"}}}}, {"name": "verbose_tool", "description": "This tool does one small thing, but its description repeats endlessly to bloat … 2 more linesbody over 16 KB — recording stopped there, so it is not checked below

Symptom

what you'll observe

A single tool eats thousands of tokens; context fills before any work happens.

Cause

what this reproduces

Dumping an entire API reference / changelog into the description field.

Fix

how you'd resolve it

Keep descriptions to a few lines; link docs instead of inlining them.

Try it with curl
bash
curl -sS -X POST \
  https://chaos-mcp.thomascdnns.com/s/huge-description/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '
"jsonrpc""2.0"
"id"1
"method""initialize"
"params"
"protocolVersion""2024-11-05"
"capabilities"
"clientInfo""name""curl""version""1"

'