THORChain Swap
Read-only THORChain swap quotes, liquidity pools, and network status.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http thorchain-swap 'https://swap.thorchain.org/mcp'{
"mcpServers": {
"thorchain-swap": {
"type": "http",
"url": "https://swap.thorchain.org/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
THORChain Swap
The official web interface for native cross-chain swaps, powered by THORChain and Maya Protocol — live at swap.thorchain.org.
Trade Bitcoin, Ethereum, stablecoins, and other layer-1 assets directly between chains: no bridges, no wrapped tokens, no order books, and no user accounts. Users connect their own wallet and sign transactions locally, or swap without connecting a wallet at all via memoless ("instant") swaps.
THORChain Developer Resources
THORChain developer resources for the swap interface — API docs, OpenAPI spec, auth docs, and MCP server:
- Developer portal — the index (Markdown: /developers.md)
- Quickstart — first swap quote in one request, no API key
- REST API reference — endpoints, error format, idempotency, versioning, sandbox
- MCP server reference — tools, parameter schemas, MCP Apps, rate limits
- Authentication — none needed here; where aggregator API keys come from
- SDKs —
@tcswap/sdkfor building swaps, plus Python (sdk/python) and Go (sdk/go) clients for the keyless public surfaces - Webhooks and event polling — how to track swap state without webhooks
- OpenAPI 3.1 description — the public REST API
- MCP server — public Model Context Protocol server at
/mcpwith swap-quote, pool, and network tools (supports MCP Apps) - Authentication model — anonymous, rate-limited public access; no key, token, or OAuth for the MCP server, and free aggregator API keys via the affiliate program
AI Agent Resources
- llms.txt — index of agent resources with when-to-use guidance
- Agent library — complete single-file reference (URL scheme, MCP examples, asset notation, quote semantics, safety rules)
- AGENTS.md — guidance and safety rules for agents using the site
AGENTS.md(repo root) — instructions for AI coding agents working on this codebase
Development
npm install
npm run devOpen http://localhost:3000. Copy .env.example to .env and fill in the API keys. Typecheck with
npx tsc --noEmit -p tsconfig.json.
See AGENTS.md for architecture notes, key paths, and conventions.
Frequently asked questions
What is THORChain Swap?
Read-only THORChain swap quotes, liquidity pools, and network status.
How do I install THORChain Swap?
It runs as a remote server. In Claude Code: claude mcp add --transport http thorchain-swap 'https://swap.thorchain.org/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does THORChain Swap need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is THORChain Swap open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains THORChain Swap?
It is published by thorchain. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.