meteora-docs-mcp

An MCP server that lets any AI assistant (Claude Code, Claude Desktop, Cursor, …) ask questions against Meteora's official documentation AI assistant at docs.meteora.ag.

It exposes a single tool:

| Tool | Description | |------|-------------| | ask_meteora_docs | Ask a natural-language question about Meteora (DBC, DAMM v1/v2, DLMM, dynamic fees & fee sharing, Alpha Vault, fee scheduling, anti-sniper config, migration, SDK usage…). Returns the assistant's answer, the doc searches it ran, and a conversationId. |

Tool inputs:

| Field | Required | Purpose | |-------|----------|---------| | question | yes | The natural-language question. | | path | no | Docs path to scope context, e.g. overview/products/dbc/what-is-dbc. | | conversationId | no | Pass back the conversationId from a previous answer to ask follow-up questions with full chat history (multi-turn). Omit to start fresh. | | reset | no | If true, clears that conversation's history before asking. |

Under the hood it uses CycleTLS (a Go TLS stack with a Chrome JA3 fingerprint) to pass Cloudflare bot detection — no browser required.

Reliability & multi-turn (v1.1.0+)

• Waits for an answer. Transient timeouts (HTTP 408), rate-limits, 5xx, transport failures, and truncated streams (a response that ends before the completion marker) are retried automatically with exponential backoff — so an empty/timed-out reply no longer leaks through.
• Real chat memory. Each answer returns a conversationId; pass it back to continue the same thread. The server replays prior turns and echoes the assistant-issued threadId/threadKey so the docs assistant treats it as one conversation.
• Tunable via env: METEORA_MCP_TIMEOUT_SEC (default 30), METEORA_MCP_MAX_ATTEMPTS (default 5), METEORA_MCP_BACKOFF_MS (default 1500), METEORA_MCP_DEBUG (set to log response header keys to stderr).

For users — add it to your MCP client

Requires Node.js ≥ 18. The first run downloads a small platform binary (CycleTLS); give it a few extra seconds.

Option A — from npm (recommended, once published)

Claude Code (CLI):

claude mcp add meteora-docs -- npx -y meteora-docs-mcp

Claude Desktop — edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "meteora-docs": {
      "command": "npx",
      "args": ["-y", "meteora-docs-mcp"]
    }
  }
}

Cursor — .cursor/mcp.json in your project (or the global one):

{
  "mcpServers": {
    "meteora-docs": {
      "command": "npx",
      "args": ["-y", "meteora-docs-mcp"]
    }
  }
}

Restart the client, then ask it something like "Use meteora-docs to explain how DBC migration works."

Option B — from source (no npm account needed)

If you received this as a folder or .zip:

cd meteora-docs-mcp
npm install

Then point your client at the absolute path of index.js:

{
  "mcpServers": {
    "meteora-docs": {
      "command": "node",
      "args": ["C:/full/path/to/meteora-docs-mcp/index.js"]
    }
  }
}

(Use forward slashes in JSON, even on Windows.)

Quick smoke test (no MCP client)

npm install            # if you haven't
node test-client.js "What is the Dynamic Bonding Curve?"

test-client.js spawns the server over stdio, runs the MCP handshake, and calls the tool once. (Included in the source tree; not published to npm.)

Troubleshooting

| Symptom | Fix | |--------|-----| | Blocked by Cloudflare (HTTP 420) | Meteora/Cloudflare changed their fingerprint detection. Update to the newest release (npx -y meteora-docs-mcp@latest). | | Antivirus / Gatekeeper flags the CycleTLS binary (index.exe on Windows, index / index-mac* on Linux/macOS) | That's the bundled CycleTLS Go binary. It's open-source; allow it, or use a machine where you can. | | Could not obtain assistant token (JWT) | Meteora changed their docs API path, or your network blocks docs.meteora.ag. | | Tool never appears in the client | Make sure nothing else prints to stdout; check the client's MCP logs (stderr) for [meteora-docs-mcp] … running on stdio. |

For the author — publish & update

See PUBLISH.md for step-by-step npm publishing and GitHub instructions.

License

MIT — see LICENSE.

Unofficial. Not affiliated with or endorsed by Meteora. Answers come from Meteora's own public documentation assistant; use at your own discretion.