THORChain MCP

org.thorchainPublished by thorchain.orgOfficial publisherv1.1.0Updated Nov 5, 2026

THORChain swap quotes, non-custodial swap prep, swap status, pools and network data.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote THORChain MCP server for swap quotes, non-custodial swap preparation, swap status, liquidity pools and network data.

What you can do
  • Quote swaps and limit orders, including expected output, fees, slippage and a memo
  • Prepare a swap with vault address, memo, guaranteed minimum and expiry
  • Check swap status and transaction details by hash, plus raw processing stages
  • List and inspect liquidity pools, with volume, fees, APY and price data
  • Read network summary, inbound vault addresses, outbound fees, last block heights and THORName details
  • Run a ping health check and a reference memo pre-flight check
When to use it
Useful when an assistant needs to answer questions about THORChain swaps, pool prices and network state, or to prepare a swap transaction the user signs in their own wallet. Also handy for checking whether a submitted swap completed or was refunded.
Requirements
A remote streamable HTTP endpoint; no package, environment variable or header is declared. No authentication is declared. Amounts are expressed in base units (1e8), so the assistant must convert them.
Before you install
prepare_swap and quote_limit return deposit addresses and memos for real transactions; the server states it never moves funds and the user signs with their own wallet, so review amounts, minimums and expiry before sending anything. Swap and limit order data is read from a public THORChain node and involves real assets and fees.

Installation

In SourceWeft

  1. Open THORChain MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/org.thorchain%2Fthorchain-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "thorchain": {
      "type": "http",
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}

Tools

16

check_reference_memo

Check Reference Memo

Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.

Parametersassetrequiredamountrequired

get_inbound_addresses

Get Inbound Addresses

Returns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.

Takes no parameters.

get_lastblock

Get Last Block Heights

Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.

Takes no parameters.

get_network_summary

Get Network Summary

Compact THORChain network status for agents: node counts, bonding/liquidity APY, reserve, pooled RUNE, next churn height, vault migration flag. Prefer this over get_network_info (full toolset only), which returns large per-node bond arrays.

Takes no parameters.

get_outbound_fees

Get Outbound Fees

Returns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.

Takes no parameters.

get_pool

Get Pool

Returns one liquidity pool by asset (e.g. BTC.BTC): depths, units, status and price. Use list_pools to find asset identifiers and get_pool_stats for volume, fees and APY.

Parametersassetrequired

get_pool_stats

Get Pool Stats

Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.

Parametersassetrequired

get_swap_status

Get Swap Status

Answers "did my swap go through?" in plain terms. Returns a status (not_found, pending, streaming, sent, refunded, completed), whether it is done, a one-line summary to tell the user, streaming progress, an estimated wait, and the refund reason. refund=true with status sent means part was refunded. Start here for swap tracking; use get_tx_status only for raw stage detail.

Parametershashrequired

get_tx

Get Transaction

Returns the observed transaction for a hash (inbound or outbound): chain, addresses, coins, memo and the heights THORChain saw it at. For "did my swap go through?" use get_swap_status.

Parametershashrequired

get_tx_status

Get Transaction Status

Returns THORNode's raw status for an inbound transaction: every processing stage, planned outbounds and sent outbounds. For a plain answer (pending, streaming, sent, refunded) use get_swap_status; use this for stage-level detail.

Parametershashrequired

list_pools

List Pools

Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.

Parameterslimitoffset

lookup_thorname

Look Up THORName

Returns THORName details including chain addresses, expiry, and owner.

Parametersnamerequired

ping

Ping THORNode

Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.

Takes no parameters.

prepare_swap

Prepare Swap

Build a ready-to-execute THORChain swap. Returns the exact vault address to send to, the memo, the source chain, the expected output and guaranteed minimum, the estimated time, and an expiry. Use this when the user wants to actually perform a swap, not just price it (for pricing only, use quote_swap). The returned instruction is what a wallet signs and broadcasts; this tool itself never moves funds.

Parametersamountrequiredto_assetrequiredaffiliatefrom_assetrequireddestinationrequiredaffiliate_bpsmax_slippage_bps

quote_limit

Quote Limit Order

Get a limit order quote with expected output, expiry time, and a generated memo for executing the limit order. Limit orders execute when the target price is reached. For an immediate market swap use quote_swap.

Parametersamountrequiredto_assetrequiredaffiliatecustom_ttlfrom_assetrequiredtarget_outrequireddestinationaffiliate_bpsrefund_addressstreaming_quantity

quote_swap

Quote Swap

Calculate how much output you would receive when swapping one asset for another. Use this tool to answer questions like 'how much ETH would I get for 100 RUNE?' Returns expected output amount, fees, slippage, estimated time, and a memo for executing the swap.

Parametersamountrequiredto_assetrequiredaffiliatefrom_assetrequireddestinationaffiliate_bps

Version history

2
  1. v1.1.0LatestNov 5, 2026
  2. v1.0.0Oct 21, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.