Name: THORChain Swap
Author: thorchain

What can you do with THORChain Swap?

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/sdk for 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 /mcp with 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 dev

Open 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.

Install

Add THORChain Swap to your client. Pick the one you use.

claude mcp add --transport http thorchain-swap https://swap.thorchain.org/mcp

codex mcp add thorchain-swap --url https://swap.thorchain.org/mcp

{
  "mcpServers": {
    "thorchain-swap": {
      "url": "https://swap.thorchain.org/mcp"
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "servers": {
    "thorchain-swap": {
      "type": "http",
      "url": "https://swap.thorchain.org/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

{
  "mcpServers": {
    "thorchain-swap": {
      "url": "https://swap.thorchain.org/mcp"
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "thorchain-swap": {
      "serverUrl": "https://swap.thorchain.org/mcp"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

Score

39 / 100

Incomplete

Documentation22/25
Maintenance19/25
Trust16/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 6 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
6 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.4.1Latest	Aug 24, 2026