THORChain MCP is answering right now. Last checked 14 min ago. It exposes 126 tools.
Read-only THORChain data: pools, network, nodes, vaults, transactions, Midgard history.
Uptime history
5 days of history
5 days agonow
100.0%
Uptime 24h
91 of 91 checks
126
Tools
read from the server
296 ms
Response time
average over 24h
open, no key
Access
streamable-http
Nothing serious here today
Today is the operative word: we check THORChain MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.
run in your terminal
claude mcp add thorchain-mcp --transport http https://mcp.thorchain.org/mcpSettings → Connectors → Add custom connector, then paste this address
https://mcp.thorchain.org/mcp~/.codex/config.toml
[mcp_servers.thorchain-mcp]
url = "https://mcp.thorchain.org/mcp".cursor/mcp.json
{
"mcpServers": {
"thorchain-mcp": {
"url": "https://mcp.thorchain.org/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"thorchain-mcp": {
"type": "http",
"url": "https://mcp.thorchain.org/mcp"
}
}
}Available tools 126
Read directly from the server with tools/list, grouped by what they act on.
If a tool disappears, we record the date.
cosmos
get_cosmos_account
Returns account information for a THORChain address including account number, sequence (nonce), and public key if available.
get_cosmos_balances
Returns account balances for a THORChain address. Shows all coin denominations held by the account.
get_cosmos_block
Returns a block at the specified height from the Cosmos SDK blockchain including header, transactions, and commit data.
get_cosmos_delegations
Returns all delegations for a delegator address. Shows which validators the address has delegated to and the amounts.
get_cosmos_latest_block
Returns the latest block from the Cosmos SDK blockchain including header, transactions, and commit data.
get_cosmos_node_info
Returns Cosmos SDK node information including network, version, protocol versions, and application version. Uses the gRPC-gateway REST API for canonical data.
get_cosmos_rewards
Returns delegation rewards for a delegator address. Shows rewards from each validator and total accumulated rewards.
get_cosmos_supply
Returns the total token supply including all coin denominations. Shows the circulating supply of RUNE and other tokens.
get_cosmos_syncing
Returns whether the node is currently syncing with the blockchain. A syncing node may have stale data.
get_cosmos_tx
Returns a transaction by hash from the Cosmos SDK blockchain. Includes transaction body, auth info, and execution result.
get_cosmos_validators
Returns the list of staking validators. Includes operator address, status, tokens, delegator shares, commission rates, and description.
search_cosmos_txs
Searches for transactions matching the query events. Supports filtering by message type, sender, recipient, and other event attributes.
cometbft
get_cometbft_block
Returns block data at the specified height including header, transactions, and commit signatures. Provides canonical blockchain data.
get_cometbft_block_results
Returns the results of executing transactions in a block, including ABCI events and validator updates. Useful for inspecting transaction outcomes.
get_cometbft_consensus_params
Returns CometBFT consensus parameters (block size, evidence, validator params) at a height.
get_cometbft_consensus_state
Returns the current consensus round state including height/round/step, proposal block hash, and vote information. Useful for debugging consensus issues.
get_cometbft_net_info
Returns network information including listening status, connected peers, and peer details. Useful for monitoring P2P network health.
get_cometbft_status
Returns the CometBFT node status including node info, sync status, and validator information. Provides canonical consensus-level data about the blockchain.
get_cometbft_tx
Returns a transaction by its hash including tx result, height, and optional proof of inclusion. Provides canonical transaction data from the consensus layer.
get_cometbft_validators
Returns the validator set at the specified height including addresses, public keys, and voting power. This is canonical consensus data about who can produce blocks.
search_cometbft_tx
Searches for transactions matching the query. Supports queries like 'tx.height=1000', 'message.action="send"', or composite queries. Returns matching transactions with optional proofs.
mimir
get_mimir
Returns THORChain protocol configuration parameters (Mimir values). These are key-value pairs that control protocol behavior like fees, limits, and feature flags.
get_mimir_admin
Returns the admin mimir configuration. These are protocol parameters set directly by THORChain admins (the dev team) rather than through node voting. Admin overrides take precedence over node votes.
get_mimir_key
Returns the effective value for a specific mimir key. This shows the final resolved value after considering admin overrides and node voting consensus. Use this to check the current value of any individual protocol parameter.
get_mimir_node
Returns the mimir settings voted by a specific node. Shows a map of mimir keys to their voted values for the given node address. Use this to see what protocol parameters a specific node operator is voting for.
list_mimir_node_votes
Returns all node operator votes on mimir settings. Each vote shows the mimir key, the voted value, and the node address that cast the vote. Use this to track node consensus on protocol parameter changes.
rune
get_rune_history
Returns historical RUNE data including price over time intervals.
get_rune_pool
Returns the RUNEPool state: protocol-owned liquidity, provider shares, reserve position, deposit limits, and pending deposits/withdrawals.
get_rune_price_history
Returns historical RUNE price data in USD over time intervals.
get_rune_provider
Returns one RUNEPool provider's position: deposited RUNE, units, and PnL.
list_rune_providers
Lists all RUNEPool providers with their deposited RUNE and units.
tcy
get_tcy_claimer
Returns TCY (ThorCoin Yeet) claimer information for a specific address. Takes the claimer's L1 address (e.g. 0x..., bc1..., ltc1...) as listed by list_tcy_claimers and returns the claims (one per asset). Use this to check an individual's TCY claims.
get_tcy_distribution
Returns TCY distribution for an address.
get_tcy_staker
Returns TCY (ThorCoin Yeet) staker information for a specific address. Shows the staked amount for the given THORChain address. Use this to check an individual's TCY staking position.
list_tcy_claimers
Returns all TCY (ThorCoin Yeet) claimers. Shows summary information for all addresses that have claimed in the TCY program.
list_tcy_stakers
Returns all TCY (ThorCoin Yeet) stakers. Shows summary information for all addresses that have staked in the TCY program.
midgard
get_midgard_balance
Returns balance for an address from Midgard analytics.
get_midgard_member
Returns liquidity provider positions for an address including pool participation, units, and deposit/withdraw history.
get_midgard_nodes
Returns node information including addresses and public keys from Midgard analytics.
get_midgard_stats
Returns global network statistics including swap counts, volumes, liquidity metrics, and RUNE price.
pool
get_pool
Returns detailed information for a specific liquidity pool by asset identifier.
get_pool_slip
Returns slip data for one pool, including current slip and rollup statistics.
get_pool_stats
Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.
list_pool_slips
Returns pool slip information for all Layer 1 pools. Pool slip measures trading activity and depth pressure. Shows current slip, rollup counts, and long-term rollup medians used for fee calculations and pool health monitoring.
trade
get_trade_account
Returns all trade account positions for a specific address. Each account includes the asset, units, owner, and last activity heights.
get_trade_unit
Returns trade unit information for a specific asset. Trade units represent the total units and depth of a trade asset pool.
list_trade_accounts
Returns all trade accounts for a specific trade asset. Each account includes the asset, units, owner address, and activity history.
list_trade_units
Returns all trade units across all trade assets. Each unit includes the asset, total units, and depth.
affiliate
get_affiliate_earnings
Returns affiliate earnings including fees collected by thorname.
get_affiliate_history
Returns historical affiliate swap data including volumes and thorname breakdown over time.
get_affiliate_stats
Returns affiliate statistics including volumes, counts, and fees by thorname.
outbound
get_outbound_fee_asset
Returns outbound fee information for a specific asset including the fee amount, surplus/deficit tracking, and dynamic multiplier.
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.
get_outbound_queue
Returns the outbound queue containing signed transactions waiting to be broadcast to external chains. Each entry includes the destination chain, address, coin amount, and gas information. These transactions have been signed and are awaiting confirmation.
reference
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.
get_reference_memo
Returns the memoless transaction memo for a given asset and reference number. Memoless transactions use the amount to encode the reference which maps to a pre-registered memo.
get_reference_memo_by_hash
Returns the memoless transaction memo for a given reference hash. Use this to look up the registered memo for a memoless transaction.
swap
get_swap_details
Returns detailed information about a specific swap including its current state. Shows the full swap message with source/target assets, amounts, destination, affiliate info, and the swap's status and queue type. Use this to track the progress of a specific swap transaction.
get_swap_history
Returns historical swap data including swap counts, volumes, fees, and average slip over time intervals.
get_swap_queue
Returns the current swap queue containing pending swaps waiting to be executed. Each entry includes source/target assets, amounts, destination addresses, and swap state. Use this to monitor swap processing and identify stuck transactions.
upgrade
get_upgrade_proposal
Returns a specific upgrade proposal by name including target block height and upgrade information.
get_upgrade_votes
Returns all node votes for a specific upgrade proposal. Each vote shows the node address and whether they approved. Use this to track upgrade consensus.
list_upgrade_proposals
Returns all pending network upgrade proposals. Each proposal includes the upgrade name, target block height, and upgrade info. Use this to monitor upcoming network changes.
vault
get_vault
Returns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.
get_vault_pubkeys
Returns all vault public keys organized by type: Asgard (active network vaults), Yggdrasil (node vaults), and inactive vaults. Includes router addresses and membership information.
get_vault_solvency
Returns aggregate vault solvency showing over-solvent or under-solvent amounts per asset. Positive amounts indicate over-solvency (more assets than expected), negative amounts indicate under-solvency. Critical for monitoring vault health.
derived
get_derived_pool
Returns one derived (virtual) pool's depths and status.
list_derived_pools
Lists all derived (virtual) pools with their depths and status.
keygen
get_keygen
Returns keygen information for a specific block height and pubkey. Shows details of the key generation ceremony including the keygen block, member nodes, and signature. Use this to investigate vault creation events.
get_keygen_metric
Returns keygen timing metrics for a specific vault public key.
keysign
get_keysign
Returns keysign information for a specific block height. Shows transactions that were scheduled to be signed at that height, including outbound transaction details. Use this to investigate signing operations at a particular block.
get_keysign_pubkey
Returns keysign information for a specific block height and vault pubkey. Shows transactions signed by a particular vault at that height. Use this to investigate a specific vault's signing activity.
lastblock
get_lastblock
Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.
get_lastblock_chain
Returns the last observed and signed block heights for a specific chain. Useful for monitoring a particular chain's sync status.
limit
get_limit_swaps
Returns the limit swaps queue containing pending limit orders. Each entry includes swap details, ratio, age, and expiry information. Supports filtering by source/target asset, sender, and pagination. Limit orders only work when AdvSwapQueueEnabled is true.
get_limit_swaps_summary
Returns a summary of the limit swaps queue including total count, total USD value, breakdown by asset pair, oldest swap age, and average age. Useful for getting an overview of pending limit orders without retrieving all individual swaps.
liquidity
get_liquidity_history
Returns historical liquidity change data including add/withdraw counts, volumes, and net liquidity over time intervals.
list_liquidity_providers
Returns all liquidity providers for a specific pool. Each entry includes the LP's units, pending amounts, deposit values, and addresses. Use this to analyze pool participation.
network
get_network_info
Returns THORChain network statistics and health information including bond metrics, pool data, and node counts.
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, which returns large per-node bond arrays.
oracle
get_oracle_price
Returns the oracle price for a specific asset symbol. The price is returned in USD and is used for protocol calculations and limit order pricing.
get_oracle_prices
Returns all oracle prices for supported assets. Oracle prices are used for determining asset values in the protocol and for pricing limit orders. Returns an array of price objects containing symbol (e.g., BTC, ETH) and price in USD.
quote
quote_limit
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.
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.
stable
get_stable_reserve
Returns the Stable Reserve module status: RUNE balance, depeg tolerance, POL share, per-asset inventory with health flags and oracle prices, and active deployment swaps. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.
get_stable_reserve_contributor
Returns a contributor's Stable Reserve credit for a given stable asset and address. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.
streaming
get_streaming_swap
Returns details of a specific streaming swap by transaction hash, including progress (count/quantity), amounts swapped (in/out), and any failed sub-swaps.
list_streaming_swaps
Returns all active streaming swaps. Streaming swaps split large trades into smaller chunks executed over multiple blocks to minimize slippage. Supports pagination with limit and offset parameters.
thorname
get_thorname
Returns THORName registration information including owner, expiry, and registered chain addresses. THORNames are human-readable aliases for blockchain addresses.
get_thorname_owner
Returns THORNames owned by an address.
asgard
list_asgard_vaults
Returns current Asgard vaults with their pubkeys, coin balances, status, membership, and chain addresses. Asgard vaults are the main network vaults that hold user funds. Supports pagination with limit and offset parameters.
ban
get_ban
Returns the ban status for a node address. Shows if the node is banned, at what block height, and which nodes signed the ban. Bans are used to remove malicious or misbehaving nodes.
block
get_block
Returns verbose details of a THORChain block including header info, transactions, and block events. If no height is specified, returns the latest block. Shows block hash, chain ID, height, time, validator info, and all transactions with their results.
bonds
get_bonds
Returns bond details for an address including associated nodes and total bonded amount.
churns
get_churns
Returns churn event history with dates and block heights.
constants
get_constants
Returns protocol constants including integer, boolean, and string configuration values that govern THORChain behavior.
depth
get_depth_history
Returns historical depth data for a pool including asset depth, RUNE depth, asset price, and liquidity units over time intervals.
details
get_tx_details
Returns comprehensive transaction details including observed transactions, actions taken, outbound transactions, consensus and finalized heights, and whether the vault was updated or the transaction reverted. Use this for deep transaction analysis.
dynamic
get_dynamic_l1_fees
Returns per-THORName dynamic L1 minimum swap-fee floors (ADR-026). Each entry shows the enrolled THORName, trading pair, current dynamic fee floor in basis points, whitelist state (1=Active, 2=Monitor), last active epoch, and latest fee revenue in TOR.
earnings
get_earnings_history
Returns historical earnings data including liquidity fees, block rewards, and bonding/liquidity earnings over time intervals.
get
get_tx
Returns transaction details for a given hash including observed transaction data, status, and processing stages.
holders
get_holders
Returns top RUNE holders with their balances.
inbound
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.
invariant
get_invariant
Runs a specific protocol invariant check and returns the result. Shows whether the invariant is broken and any informative messages about the check. Use this to verify protocol consistency and detect potential issues.
invariants
list_invariants
Returns the list of available protocol invariants that can be checked. Invariants are consistency checks that verify the protocol's internal state is valid. Common invariants include 'asgard', 'bond', 'pools', 'thorchain', etc.
known
get_known_pools
Returns known pools with their status (available, staged, suspended).
lookup
lookup_thorname
Returns THORName details including chain addresses, expiry, and owner.
members
get_members
Returns list of all liquidity provider addresses.
node
get_node
Returns detailed information for a specific validator node including bond, status, version, and performance metrics. Bond providers include their Bond Yield configuration (bps share of rewards paid out automatically and its payout_target) when one is set.
nodes
list_nodes
Returns all registered validator nodes with their status, bond amounts, and operational information. Each bond provider may carry a Bond Yield configuration (bps share of rewards paid out automatically and its payout_target); the fields are absent on nodes without one. Supports pagination with limit and offset parameters.
ping
ping
Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.
pools
list_pools
Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.
position
get_lp_position
Returns liquidity provider position information for a specific address in a pool. Includes units, pending asset/rune, and last add/withdraw heights.
prepare
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.
queue
get_queue
Returns queue statistics including pending swap count, outbound transaction count, internal queue size, and scheduled outbound value. Use this to understand network congestion.
ragnarok
get_ragnarok
Returns whether the chain is in Ragnarok (emergency shutdown mode). Ragnarok is triggered when the network needs to return all funds to users. A true value indicates the network is shutting down.
reverse
reverse_lookup_thorname
Returns THORNames associated with an address.
runepool
get_runepool_member
Returns Midgard's analytics view of a RUNEPool member: deposit/withdraw history and current units.
scheduled
get_scheduled_queue
Returns the scheduled outbound queue containing transactions waiting to be signed and broadcast. Each entry includes the destination chain, address, coin amount, gas rate, and associated memo. Transactions are scheduled based on outbound delay.
stages
get_tx_stages
Returns detailed processing stages of an inbound transaction including observation counts, confirmation status, swap status (with streaming progress if applicable), outbound delay, and signing status.
status
get_tx_status
Returns comprehensive transaction status including processing stages, planned outbound transactions, and completed outbound transactions. Use this to track swap progress.
swapper
get_swapper_clout
Returns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.
tss
get_tss_metrics
Returns TSS keygen and keysign timing metrics across the validator set.
tvl
get_tvl_history
Returns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.
version
get_version
Returns network version information including current version, next required version for nodes, and the querier version.
votes
get_votes
Returns governance votes including parameter proposals and node votes.
Endpoints
| URL | Transport | State | Latency | Checked |
|---|---|---|---|---|
| https://mcp.thorchain.org/mcp | streamable-http | answering | 270 ms | 14 min ago |
Alternatives to THORChain MCP
same job, measured the same wayParallax Protocol
by parallaxprotocol
Read-only Parallax PoW chain data: blocks, transactions, mining, supply, explorer and network health
THORChain Swap
by thorchain-swap
Read-only THORChain swap quotes, liquidity pools, and network status.
midnight-cast
by kanasjnr
Read-only tools for live Midnight networks: health, transactions, DUST, errors and example code
Ankr Agent RPC
by w3tech
Read chain data on 200+ networks and Sui: transactions, logs, balances, objects, ABI-decoded.
Fuse Network
by fuse
MCP server for Fuse Network: balances, tokens, staking, DeFi data, swaps and on-chain transactions.
Etherscan
by etherscan
Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs.
Paypal
by pipeworx-io
PayPal MCP Pack — read-only access to PayPal transactions, orders, invoices, and disputes.
PostgreSQL (hardened, read-only)
by eszetael
Read-only PostgreSQL over MCP. Writes refused at the parsed SQL, plus a READ ONLY transaction.
THORChain MCP — questions
Answers built from our own checks of this server.
What can THORChain MCP do?
It exposes 126 tools, read directly from the server on our last check. Among them: check_reference_memo, get_affiliate_earnings, get_affiliate_history, get_affiliate_stats, get_ban, get_block and 120 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README.
How MCP servers expose tools in the first place →
What is THORChain MCP mostly used for?
Its tools cluster around cosmos, cometbft and tcy. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is THORChain MCP working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 296 ms. The bar chart above shows every period we have measured.
How do I connect THORChain MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does THORChain MCP need an API key?
No. THORChain MCP completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 126 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is THORChain MCP?
It answers our handshake in 296 ms on average, which is faster than 56% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.