THORChain Swap API Authentication

How agents authenticate against THORChain Swap (https://swap.thorchain.org): they do not.

Which credential do I need?

Anonymous by design

There are no user accounts on this site. Browsing and the public REST endpoints are anonymous; the canonical core MCP server is anonymous too. Support API limits are local to this site; MCP limits are owned by the core deployment. Wallet connection and transaction signing happen in the user's own wallet; memoless ("instant") swaps need no wallet at all. Nothing on this site can move funds, so nothing on it needs a credential.

No authorization server

This site publishes no /.well-known/oauth-protected-resource and no /.well-known/oauth-authorization-server, and that is deliberate.

MCP clients treat the presence of protected-resource metadata as "this server requires OAuth". A connector that finds it will start a sign-in flow — dynamic client registration, then an authorization-code redirect — and fail, because there is no user account here to sign in to and nothing for a token to unlock. Serving no authorization metadata is what lets a client conclude the server is open and connect on the first try.

So: if a client asks for an OAuth client ID, an API key, or a bearer token for https://mcp.thorchain.org/mcp, leave the field blank. Adding the URL is the whole setup:

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

Partner API keys (the affiliate program)

The swap aggregator that powers this interface — https://api.thorchain.org/v1, quotes and routing across every supported provider — is x-api-key gated. Keys are free:

  1. Register at https://affiliate.thorchain.org with your name, email, website, and Telegram, and verify the email.
  2. The account is reviewed; the API key is issued once it is approved.
  3. The same dashboard configures affiliate and service fee splits per provider, generates the embeddable swap widget, and reports earnings.

Use that key with `@tcswap/sdk`, which takes it as the uSwap API key. The memoless API and the canonical core MCP server need no key at all.

Related

This page as markdown: /developers/auth.md