Skip to content

THORChain Swap

by swap.thorchain.org · remote · no sign-in to list tools · v0.4.1 · published by org.thorchain.swap

Read-only THORChain swap quotes, liquidity pools, and network status.

Changes · 4

126 tools: 4 change things and 122 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "get_invariant" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"idempotentHint":false}; The name "get_invariant" says "get": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

126 tools

Changes things 4Claude Code: ask
  • check_reference_memoPre-flight check for memoless transactions.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_invariantRuns a specific protocol invariant check and returns the result.1 finding

    Why it is in this group

    • The name "get_invariant" says "get": a word for reading.
    • The description's first verb is "run": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "get_invariant" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"idempotentHint":false}; The name "get_invariant" says "get": a word for reading.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • prepare_swapBuild a ready-to-execute THORChain swap.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • quote_swapCalculate how much output you would receive when swapping one asset for another.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
Only reads 122Claude Code: allow
  • get_affiliate_earningsReturns affiliate earnings including fees collected by thorname.No findings

    Why it is in this group

    • The name "get_affiliate_earnings" says "get": a word for reading.
    Description, as the server wrote it
    Returns affiliate earnings including fees collected by thorname.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_affiliate_historyReturns historical affiliate swap data including volumes and thorname breakdown over time.No findings

    Why it is in this group

    • The name "get_affiliate_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical affiliate swap data including volumes and thorname breakdown over time.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_affiliate_statsReturns affiliate statistics including volumes, counts, and fees by thorname.No findings

    Why it is in this group

    • The name "get_affiliate_stats" says "get": a word for reading.
    Description, as the server wrote it
    Returns affiliate statistics including volumes, counts, and fees by thorname.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_banReturns the ban status for a node address.No findings

    Why it is in this group

    • The name "get_ban" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_blockReturns verbose details of a THORChain block including header info, transactions, and block events.No findings

    Why it is in this group

    • The name "get_block" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_bondsReturns bond details for an address including associated nodes and total bonded amount.No findings

    Why it is in this group

    • The name "get_bonds" says "get": a word for reading.
    Description, as the server wrote it
    Returns bond details for an address including associated nodes and total bonded amount.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_churnsReturns churn event history with dates and block heights.No findings

    Why it is in this group

    • The name "get_churns" says "get": a word for reading.
    Description, as the server wrote it
    Returns churn event history with dates and block heights.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_blockReturns block data at the specified height including header, transactions, and commit signatures.No findings

    Why it is in this group

    • The name "get_cometbft_block" says "get": a word for reading.
    Description, as the server wrote it
    Returns block data at the specified height including header, transactions, and commit signatures. Provides canonical blockchain data.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_block_resultsReturns the results of executing transactions in a block, including ABCI events and validator updates.No findings

    Why it is in this group

    • The name "get_cometbft_block_results" says "get": a word for reading.
    Description, as the server wrote it
    Returns the results of executing transactions in a block, including ABCI events and validator updates. Useful for inspecting transaction outcomes.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_consensus_paramsReturns CometBFT consensus parameters (block size, evidence, validator params) at a height.No findings

    Why it is in this group

    • The name "get_cometbft_consensus_params" says "get": a word for reading.
    Description, as the server wrote it
    Returns CometBFT consensus parameters (block size, evidence, validator params) at a height.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_consensus_stateReturns the current consensus round state including height/round/step, proposal block hash, and vote information.No findings

    Why it is in this group

    • The name "get_cometbft_consensus_state" says "get": a word for reading.
    Description, as the server wrote it
    Returns the current consensus round state including height/round/step, proposal block hash, and vote information. Useful for debugging consensus issues.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_net_infoReturns network information including listening status, connected peers, and peer details.No findings

    Why it is in this group

    • The name "get_cometbft_net_info" says "get": a word for reading.
    Description, as the server wrote it
    Returns network information including listening status, connected peers, and peer details. Useful for monitoring P2P network health.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_statusReturns the CometBFT node status including node info, sync status, and validator information.No findings

    Why it is in this group

    • The name "get_cometbft_status" says "get": a word for reading.
    Description, as the server wrote it
    Returns the CometBFT node status including node info, sync status, and validator information. Provides canonical consensus-level data about the blockchain.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_txReturns a transaction by its hash including tx result, height, and optional proof of inclusion.No findings

    Why it is in this group

    • The name "get_cometbft_tx" says "get": a word for reading.
    Description, as the server wrote it
    Returns a transaction by its hash including tx result, height, and optional proof of inclusion. Provides canonical transaction data from the consensus layer.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cometbft_validatorsReturns the validator set at the specified height including addresses, public keys, and voting power.No findings

    Why it is in this group

    • The name "get_cometbft_validators" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_constantsReturns protocol constants including integer, boolean, and string configuration values that govern THORChain behavior.No findings

    Why it is in this group

    • The name "get_constants" says "get": a word for reading.
    Description, as the server wrote it
    Returns protocol constants including integer, boolean, and string configuration values that govern THORChain behavior.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_accountReturns account information for a THORChain address including account number, sequence (nonce), and public key if available.No findings

    Why it is in this group

    • The name "get_cosmos_account" says "get": a word for reading.
    Description, as the server wrote it
    Returns account information for a THORChain address including account number, sequence (nonce), and public key if available.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_balancesReturns account balances for a THORChain address.No findings

    Why it is in this group

    • The name "get_cosmos_balances" says "get": a word for reading.
    Description, as the server wrote it
    Returns account balances for a THORChain address. Shows all coin denominations held by the account.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_blockReturns a block at the specified height from the Cosmos SDK blockchain including header, transactions, and commit data.No findings

    Why it is in this group

    • The name "get_cosmos_block" says "get": a word for reading.
    Description, as the server wrote it
    Returns a block at the specified height from the Cosmos SDK blockchain including header, transactions, and commit data.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_delegationsReturns all delegations for a delegator address.No findings

    Why it is in this group

    • The name "get_cosmos_delegations" says "get": a word for reading.
    Description, as the server wrote it
    Returns all delegations for a delegator address. Shows which validators the address has delegated to and the amounts.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_latest_blockReturns the latest block from the Cosmos SDK blockchain including header, transactions, and commit data.No findings

    Why it is in this group

    • The name "get_cosmos_latest_block" says "get": a word for reading.
    Description, as the server wrote it
    Returns the latest block from the Cosmos SDK blockchain including header, transactions, and commit data.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_node_infoReturns Cosmos SDK node information including network, version, protocol versions, and application version.No findings

    Why it is in this group

    • The name "get_cosmos_node_info" says "get": a word for reading.
    Description, as the server wrote it
    Returns Cosmos SDK node information including network, version, protocol versions, and application version. Uses the gRPC-gateway REST API for canonical data.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_rewardsReturns delegation rewards for a delegator address.No findings

    Why it is in this group

    • The name "get_cosmos_rewards" says "get": a word for reading.
    Description, as the server wrote it
    Returns delegation rewards for a delegator address. Shows rewards from each validator and total accumulated rewards.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_supplyReturns the total token supply including all coin denominations.No findings

    Why it is in this group

    • The name "get_cosmos_supply" says "get": a word for reading.
    Description, as the server wrote it
    Returns the total token supply including all coin denominations. Shows the circulating supply of RUNE and other tokens.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_syncingReturns whether the node is currently syncing with the blockchain.No findings

    Why it is in this group

    • The name "get_cosmos_syncing" says "get": a word for reading.
    Description, as the server wrote it
    Returns whether the node is currently syncing with the blockchain. A syncing node may have stale data.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_txReturns a transaction by hash from the Cosmos SDK blockchain.No findings

    Why it is in this group

    • The name "get_cosmos_tx" says "get": a word for reading.
    Description, as the server wrote it
    Returns a transaction by hash from the Cosmos SDK blockchain. Includes transaction body, auth info, and execution result.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_cosmos_validatorsReturns the list of staking validators.No findings

    Why it is in this group

    • The name "get_cosmos_validators" says "get": a word for reading.
    Description, as the server wrote it
    Returns the list of staking validators. Includes operator address, status, tokens, delegator shares, commission rates, and description.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_depth_historyReturns historical depth data for a pool including asset depth, RUNE depth, asset price, and liquidity units over time intervals.No findings

    Why it is in this group

    • The name "get_depth_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical depth data for a pool including asset depth, RUNE depth, asset price, and liquidity units over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_derived_poolReturns one derived (virtual) pool's depths and status.No findings

    Why it is in this group

    • The name "get_derived_pool" says "get": a word for reading.
    Description, as the server wrote it
    Returns one derived (virtual) pool's depths and status.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_dynamic_l1_feesReturns per-THORName dynamic L1 minimum swap-fee floors (ADR-026).No findings

    Why it is in this group

    • The name "get_dynamic_l1_fees" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_earnings_historyReturns historical earnings data including liquidity fees, block rewards, and bonding/liquidity earnings over time intervals.No findings

    Why it is in this group

    • The name "get_earnings_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical earnings data including liquidity fees, block rewards, and bonding/liquidity earnings over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_holdersReturns top RUNE holders with their balances.No findings

    Why it is in this group

    • The name "get_holders" says "get": a word for reading.
    Description, as the server wrote it
    Returns top RUNE holders with their balances.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_inbound_addressesReturns vault addresses for depositing assets into THORChain.No findings

    Why it is in this group

    • The name "get_inbound_addresses" says "get": a word for reading.
    Description, as the server wrote it
    Returns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_keygenReturns keygen information for a specific block height and pubkey.No findings

    Why it is in this group

    • The name "get_keygen" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_keygen_metricReturns keygen timing metrics for a specific vault public key.No findings

    Why it is in this group

    • The name "get_keygen_metric" says "get": a word for reading.
    Description, as the server wrote it
    Returns keygen timing metrics for a specific vault public key.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_keysignReturns keysign information for a specific block height.No findings

    Why it is in this group

    • The name "get_keysign" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_keysign_pubkeyReturns keysign information for a specific block height and vault pubkey.No findings

    Why it is in this group

    • The name "get_keysign_pubkey" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_known_poolsReturns known pools with their status (available, staged, suspended).No findings

    Why it is in this group

    • The name "get_known_pools" says "get": a word for reading.
    Description, as the server wrote it
    Returns known pools with their status (available, staged, suspended).

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_lastblockReturns the last observed and signed block heights for all chains.No findings

    Why it is in this group

    • The name "get_lastblock" says "get": a word for reading.
    Description, as the server wrote it
    Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_lastblock_chainReturns the last observed and signed block heights for a specific chain.No findings

    Why it is in this group

    • The name "get_lastblock_chain" says "get": a word for reading.
    Description, as the server wrote it
    Returns the last observed and signed block heights for a specific chain. Useful for monitoring a particular chain's sync status.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_limit_swapsReturns the limit swaps queue containing pending limit orders.No findings

    Why it is in this group

    • The name "get_limit_swaps" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_limit_swaps_summaryReturns a summary of the limit swaps queue including total count, total USD value, breakdown by asset pair, oldest swap age, and average age.No findings

    Why it is in this group

    • The name "get_limit_swaps_summary" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_liquidity_historyReturns historical liquidity change data including add/withdraw counts, volumes, and net liquidity over time intervals.No findings

    Why it is in this group

    • The name "get_liquidity_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical liquidity change data including add/withdraw counts, volumes, and net liquidity over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_lp_positionReturns liquidity provider position information for a specific address in a pool.No findings

    Why it is in this group

    • The name "get_lp_position" says "get": a word for reading.
    Description, as the server wrote it
    Returns liquidity provider position information for a specific address in a pool. Includes units, pending asset/rune, and last add/withdraw heights.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_membersReturns list of all liquidity provider addresses.No findings

    Why it is in this group

    • The name "get_members" says "get": a word for reading.
    Description, as the server wrote it
    Returns list of all liquidity provider addresses.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_midgard_balanceReturns balance for an address from Midgard analytics.No findings

    Why it is in this group

    • The name "get_midgard_balance" says "get": a word for reading.
    Description, as the server wrote it
    Returns balance for an address from Midgard analytics.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_midgard_memberReturns liquidity provider positions for an address including pool participation, units, and deposit/withdraw history.No findings

    Why it is in this group

    • The name "get_midgard_member" says "get": a word for reading.
    Description, as the server wrote it
    Returns liquidity provider positions for an address including pool participation, units, and deposit/withdraw history.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_midgard_nodesReturns node information including addresses and public keys from Midgard analytics.No findings

    Why it is in this group

    • The name "get_midgard_nodes" says "get": a word for reading.
    Description, as the server wrote it
    Returns node information including addresses and public keys from Midgard analytics.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_midgard_statsReturns global network statistics including swap counts, volumes, liquidity metrics, and RUNE price.No findings

    Why it is in this group

    • The name "get_midgard_stats" says "get": a word for reading.
    Description, as the server wrote it
    Returns global network statistics including swap counts, volumes, liquidity metrics, and RUNE price.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_mimirReturns THORChain protocol configuration parameters (Mimir values).No findings

    Why it is in this group

    • The name "get_mimir" says "get": a word for reading.
    Description, as the server wrote it
    Returns THORChain protocol configuration parameters (Mimir values). These are key-value pairs that control protocol behavior like fees, limits, and feature flags.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_mimir_adminReturns the admin mimir configuration.No findings

    Why it is in this group

    • The name "get_mimir_admin" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_mimir_keyReturns the effective value for a specific mimir key.No findings

    Why it is in this group

    • The name "get_mimir_key" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_mimir_nodeReturns the mimir settings voted by a specific node.No findings

    Why it is in this group

    • The name "get_mimir_node" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_network_infoReturns THORChain network statistics and health information including bond metrics, pool data, and node counts.No findings

    Why it is in this group

    • The name "get_network_info" says "get": a word for reading.
    Description, as the server wrote it
    Returns THORChain network statistics and health information including bond metrics, pool data, and node counts.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_network_summaryCompact THORChain network status for agents: node counts, bonding/liquidity APY, reserve, pooled RUNE, next churn height, vault migration flag.No findings

    Why it is in this group

    • The name "get_network_summary" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_nodeReturns detailed information for a specific validator node including bond, status, version, and performance metrics.No findings

    Why it is in this group

    • The name "get_node" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_oracle_priceReturns the oracle price for a specific asset symbol.No findings

    Why it is in this group

    • The name "get_oracle_price" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_oracle_pricesReturns all oracle prices for supported assets.No findings

    Why it is in this group

    • The name "get_oracle_prices" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_outbound_fee_assetReturns outbound fee information for a specific asset including the fee amount, surplus/deficit tracking, and dynamic multiplier.No findings

    Why it is in this group

    • The name "get_outbound_fee_asset" says "get": a word for reading.
    Description, as the server wrote it
    Returns outbound fee information for a specific asset including the fee amount, surplus/deficit tracking, and dynamic multiplier.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_outbound_feesReturns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier.No findings

    Why it is in this group

    • The name "get_outbound_fees" says "get": a word for reading.
    Description, as the server wrote it
    Returns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_outbound_queueReturns the outbound queue containing signed transactions waiting to be broadcast to external chains.No findings

    Why it is in this group

    • The name "get_outbound_queue" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_poolReturns detailed information for a specific liquidity pool by asset identifier.No findings

    Why it is in this group

    • The name "get_pool" says "get": a word for reading.
    Description, as the server wrote it
    Returns detailed information for a specific liquidity pool by asset identifier.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_pool_slipReturns slip data for one pool, including current slip and rollup statistics.No findings

    Why it is in this group

    • The name "get_pool_slip" says "get": a word for reading.
    Description, as the server wrote it
    Returns slip data for one pool, including current slip and rollup statistics.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_pool_statsReturns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.No findings

    Why it is in this group

    • The name "get_pool_stats" says "get": a word for reading.
    Description, as the server wrote it
    Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_queueReturns queue statistics including pending swap count, outbound transaction count, internal queue size, and scheduled outbound value.No findings

    Why it is in this group

    • The name "get_queue" says "get": a word for reading.
    Description, as the server wrote it
    Returns queue statistics including pending swap count, outbound transaction count, internal queue size, and scheduled outbound value. Use this to understand network congestion.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_ragnarokReturns whether the chain is in Ragnarok (emergency shutdown mode).No findings

    Why it is in this group

    • The name "get_ragnarok" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_reference_memoReturns the memoless transaction memo for a given asset and reference number.No findings

    Why it is in this group

    • The name "get_reference_memo" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_reference_memo_by_hashReturns the memoless transaction memo for a given reference hash.No findings

    Why it is in this group

    • The name "get_reference_memo_by_hash" says "get": a word for reading.
    Description, as the server wrote it
    Returns the memoless transaction memo for a given reference hash. Use this to look up the registered memo for a memoless transaction.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_rune_historyReturns historical RUNE data including price over time intervals.No findings

    Why it is in this group

    • The name "get_rune_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical RUNE data including price over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_rune_poolReturns the RUNEPool state: protocol-owned liquidity, provider shares, reserve position, deposit limits, and pending deposits/withdrawals.No findings

    Why it is in this group

    • The name "get_rune_pool" says "get": a word for reading.
    Description, as the server wrote it
    Returns the RUNEPool state: protocol-owned liquidity, provider shares, reserve position, deposit limits, and pending deposits/withdrawals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_rune_price_historyReturns historical RUNE price data in USD over time intervals.No findings

    Why it is in this group

    • The name "get_rune_price_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical RUNE price data in USD over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_rune_providerReturns one RUNEPool provider's position: deposited RUNE, units, and PnL.No findings

    Why it is in this group

    • The name "get_rune_provider" says "get": a word for reading.
    Description, as the server wrote it
    Returns one RUNEPool provider's position: deposited RUNE, units, and PnL.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_runepool_memberReturns Midgard's analytics view of a RUNEPool member: deposit/withdraw history and current units.No findings

    Why it is in this group

    • The name "get_runepool_member" says "get": a word for reading.
    Description, as the server wrote it
    Returns Midgard's analytics view of a RUNEPool member: deposit/withdraw history and current units.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_scheduled_queueReturns the scheduled outbound queue containing transactions waiting to be signed and broadcast.No findings

    Why it is in this group

    • The name "get_scheduled_queue" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_stable_reserveReturns the Stable Reserve module status: RUNE balance, depeg tolerance, POL share, per-asset inventory with health flags and oracle prices, and active deployment swaps.No findings

    Why it is in this group

    • The name "get_stable_reserve" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_stable_reserve_contributorReturns a contributor's Stable Reserve credit for a given stable asset and address.No findings

    Why it is in this group

    • The name "get_stable_reserve_contributor" says "get": a word for reading.
    Description, as the server wrote it
    Returns a contributor's Stable Reserve credit for a given stable asset and address. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_streaming_swapReturns details of a specific streaming swap by transaction hash, including progress (count/quantity), amounts swapped (in/out), and any failed sub-swaps.No findings

    Why it is in this group

    • The name "get_streaming_swap" says "get": a word for reading.
    Description, as the server wrote it
    Returns details of a specific streaming swap by transaction hash, including progress (count/quantity), amounts swapped (in/out), and any failed sub-swaps.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_swap_detailsReturns detailed information about a specific swap including its current state.No findings

    Why it is in this group

    • The name "get_swap_details" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_swap_historyReturns historical swap data including swap counts, volumes, fees, and average slip over time intervals.No findings

    Why it is in this group

    • The name "get_swap_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical swap data including swap counts, volumes, fees, and average slip over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_swap_queueReturns the current swap queue containing pending swaps waiting to be executed.No findings

    Why it is in this group

    • The name "get_swap_queue" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_swapper_cloutReturns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.No findings

    Why it is in this group

    • The name "get_swapper_clout" says "get": a word for reading.
    Description, as the server wrote it
    Returns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tcy_claimerReturns TCY (ThorCoin Yeet) claimer information for a specific address.No findings

    Why it is in this group

    • The name "get_tcy_claimer" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tcy_distributionReturns TCY distribution for an address.No findings

    Why it is in this group

    • The name "get_tcy_distribution" says "get": a word for reading.
    Description, as the server wrote it
    Returns TCY distribution for an address.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tcy_stakerReturns TCY (ThorCoin Yeet) staker information for a specific address.No findings

    Why it is in this group

    • The name "get_tcy_staker" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_thornameReturns THORName registration information including owner, expiry, and registered chain addresses.No findings

    Why it is in this group

    • The name "get_thorname" says "get": a word for reading.
    Description, as the server wrote it
    Returns THORName registration information including owner, expiry, and registered chain addresses. THORNames are human-readable aliases for blockchain addresses.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_thorname_ownerReturns THORNames owned by an address.No findings

    Why it is in this group

    • The name "get_thorname_owner" says "get": a word for reading.
    Description, as the server wrote it
    Returns THORNames owned by an address.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_trade_accountReturns all trade account positions for a specific address.No findings

    Why it is in this group

    • The name "get_trade_account" says "get": a word for reading.
    Description, as the server wrote it
    Returns all trade account positions for a specific address. Each account includes the asset, units, owner, and last activity heights.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_trade_unitReturns trade unit information for a specific asset.No findings

    Why it is in this group

    • The name "get_trade_unit" says "get": a word for reading.
    Description, as the server wrote it
    Returns trade unit information for a specific asset. Trade units represent the total units and depth of a trade asset pool.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tss_metricsReturns TSS keygen and keysign timing metrics across the validator set.No findings

    Why it is in this group

    • The name "get_tss_metrics" says "get": a word for reading.
    Description, as the server wrote it
    Returns TSS keygen and keysign timing metrics across the validator set.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tvl_historyReturns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.No findings

    Why it is in this group

    • The name "get_tvl_history" says "get": a word for reading.
    Description, as the server wrote it
    Returns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_txReturns transaction details for a given hash including observed transaction data, status, and processing stages.No findings

    Why it is in this group

    • The name "get_tx" says "get": a word for reading.
    Description, as the server wrote it
    Returns transaction details for a given hash including observed transaction data, status, and processing stages.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tx_detailsReturns comprehensive transaction details including observed transactions, actions taken, outbound transactions, consensus and finalized heights, and whether the vault was updated …No findings

    Why it is in this group

    • The name "get_tx_details" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tx_stagesReturns detailed processing stages of an inbound transaction including observation counts, confirmation status, swap status (with streaming progress if applicable), outbound delay,…No findings

    Why it is in this group

    • The name "get_tx_stages" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_tx_statusReturns comprehensive transaction status including processing stages, planned outbound transactions, and completed outbound transactions.No findings

    Why it is in this group

    • The name "get_tx_status" says "get": a word for reading.
    Description, as the server wrote it
    Returns comprehensive transaction status including processing stages, planned outbound transactions, and completed outbound transactions. Use this to track swap progress.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_upgrade_proposalReturns a specific upgrade proposal by name including target block height and upgrade information.No findings

    Why it is in this group

    • The name "get_upgrade_proposal" says "get": a word for reading.
    Description, as the server wrote it
    Returns a specific upgrade proposal by name including target block height and upgrade information.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_upgrade_votesReturns all node votes for a specific upgrade proposal.No findings

    Why it is in this group

    • The name "get_upgrade_votes" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_vaultReturns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.No findings

    Why it is in this group

    • The name "get_vault" says "get": a word for reading.
    Description, as the server wrote it
    Returns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_vault_pubkeysReturns all vault public keys organized by type: Asgard (active network vaults), Yggdrasil (node vaults), and inactive vaults.No findings

    Why it is in this group

    • The name "get_vault_pubkeys" says "get": a word for reading.
    Description, as the server wrote it
    Returns all vault public keys organized by type: Asgard (active network vaults), Yggdrasil (node vaults), and inactive vaults. Includes router addresses and membership information.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_vault_solvencyReturns aggregate vault solvency showing over-solvent or under-solvent amounts per asset.No findings

    Why it is in this group

    • The name "get_vault_solvency" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_versionReturns network version information including current version, next required version for nodes, and the querier version.No findings

    Why it is in this group

    • The name "get_version" says "get": a word for reading.
    Description, as the server wrote it
    Returns network version information including current version, next required version for nodes, and the querier version.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • get_votesReturns governance votes including parameter proposals and node votes.No findings

    Why it is in this group

    • The name "get_votes" says "get": a word for reading.
    Description, as the server wrote it
    Returns governance votes including parameter proposals and node votes.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_asgard_vaultsReturns current Asgard vaults with their pubkeys, coin balances, status, membership, and chain addresses.No findings

    Why it is in this group

    • The name "list_asgard_vaults" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_derived_poolsLists all derived (virtual) pools with their depths and status.No findings

    Why it is in this group

    • The name "list_derived_pools" says "list": a word for reading.
    Description, as the server wrote it
    Lists all derived (virtual) pools with their depths and status.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_invariantsReturns the list of available protocol invariants that can be checked.No findings

    Why it is in this group

    • The name "list_invariants" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_liquidity_providersReturns all liquidity providers for a specific pool.No findings

    Why it is in this group

    • The name "list_liquidity_providers" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_mimir_node_votesReturns all node operator votes on mimir settings.No findings

    Why it is in this group

    • The name "list_mimir_node_votes" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_nodesReturns all registered validator nodes with their status, bond amounts, and operational information.No findings

    Why it is in this group

    • The name "list_nodes" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_pool_slipsReturns pool slip information for all Layer 1 pools.No findings

    Why it is in this group

    • The name "list_pool_slips" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_poolsReturns all active liquidity pools on THORChain with their balances, units, and status.No findings

    Why it is in this group

    • The name "list_pools" says "list": a word for reading.
    Description, as the server wrote it
    Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_rune_providersLists all RUNEPool providers with their deposited RUNE and units.No findings

    Why it is in this group

    • The name "list_rune_providers" says "list": a word for reading.
    Description, as the server wrote it
    Lists all RUNEPool providers with their deposited RUNE and units.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_streaming_swapsReturns all active streaming swaps.No findings

    Why it is in this group

    • The name "list_streaming_swaps" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_tcy_claimersReturns all TCY (ThorCoin Yeet) claimers.No findings

    Why it is in this group

    • The name "list_tcy_claimers" says "list": a word for reading.
    Description, as the server wrote it
    Returns all TCY (ThorCoin Yeet) claimers. Shows summary information for all addresses that have claimed in the TCY program.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_tcy_stakersReturns all TCY (ThorCoin Yeet) stakers.No findings

    Why it is in this group

    • The name "list_tcy_stakers" says "list": a word for reading.
    Description, as the server wrote it
    Returns all TCY (ThorCoin Yeet) stakers. Shows summary information for all addresses that have staked in the TCY program.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_trade_accountsReturns all trade accounts for a specific trade asset.No findings

    Why it is in this group

    • The name "list_trade_accounts" says "list": a word for reading.
    Description, as the server wrote it
    Returns all trade accounts for a specific trade asset. Each account includes the asset, units, owner address, and activity history.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_trade_unitsReturns all trade units across all trade assets.No findings

    Why it is in this group

    • The name "list_trade_units" says "list": a word for reading.
    Description, as the server wrote it
    Returns all trade units across all trade assets. Each unit includes the asset, total units, and depth.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • list_upgrade_proposalsReturns all pending network upgrade proposals.No findings

    Why it is in this group

    • The name "list_upgrade_proposals" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • lookup_thornameReturns THORName details including chain addresses, expiry, and owner.No findings

    Why it is in this group

    • The name "lookup_thorname" says "lookup": a word for reading.
    Description, as the server wrote it
    Returns THORName details including chain addresses, expiry, and owner.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • pingHealth check endpoint.No findings

    Why it is in this group

    • The name "ping" says "ping": a word for reading.
    Description, as the server wrote it
    Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • quote_limitGet a limit order quote with expected output, expiry time, and a generated memo for executing the limit order.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • reverse_lookup_thornameReturns THORNames associated with an address.No findings

    Why it is in this group

    • The name "reverse_lookup_thorname" says "lookup": a word for reading.
    Description, as the server wrote it
    Returns THORNames associated with an address.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • search_cometbft_txSearches for transactions matching the query.No findings

    Why it is in this group

    • The name "search_cometbft_tx" says "search": a word for reading.
    Description, as the server wrote it
    Searches for transactions matching the query. Supports queries like 'tx.height=1000', 'message.action="send"', or composite queries. Returns matching transactions with optional proofs.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true
  • search_cosmos_txsSearches for transactions matching the query events.No findings

    Why it is in this group

    • The name "search_cosmos_txs" says "search": a word for reading.
    Description, as the server wrote it
    Searches for transactions matching the query events. Supports filtering by message type, sender, recipient, and other event attributes.

    Annotations the server declares

    • idempotentHint: false
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.4.1. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__thorchain-swap__get_affiliate_earnings",
      "mcp__thorchain-swap__get_affiliate_history",
      "mcp__thorchain-swap__get_affiliate_stats",
      "mcp__thorchain-swap__get_ban",
      "mcp__thorchain-swap__get_block",
      "mcp__thorchain-swap__get_bonds",
      "mcp__thorchain-swap__get_churns",
      "mcp__thorchain-swap__get_cometbft_block",
      "mcp__thorchain-swap__get_cometbft_block_results",
      "mcp__thorchain-swap__get_cometbft_consensus_params",
      "mcp__thorchain-swap__get_cometbft_consensus_state",
      "mcp__thorchain-swap__get_cometbft_net_info",
      "mcp__thorchain-swap__get_cometbft_status",
      "mcp__thorchain-swap__get_cometbft_tx",
      "mcp__thorchain-swap__get_cometbft_validators",
      "mcp__thorchain-swap__get_constants",
      "mcp__thorchain-swap__get_cosmos_account",
      "mcp__thorchain-swap__get_cosmos_balances",
      "mcp__thorchain-swap__get_cosmos_block",
      "mcp__thorchain-swap__get_cosmos_delegations",
      "mcp__thorchain-swap__get_cosmos_latest_block",
      "mcp__thorchain-swap__get_cosmos_node_info",
      "mcp__thorchain-swap__get_cosmos_rewards",
      "mcp__thorchain-swap__get_cosmos_supply",
      "mcp__thorchain-swap__get_cosmos_syncing",
      "mcp__thorchain-swap__get_cosmos_tx",
      "mcp__thorchain-swap__get_cosmos_validators",
      "mcp__thorchain-swap__get_depth_history",
      "mcp__thorchain-swap__get_derived_pool",
      "mcp__thorchain-swap__get_dynamic_l1_fees",
      "mcp__thorchain-swap__get_earnings_history",
      "mcp__thorchain-swap__get_holders",
      "mcp__thorchain-swap__get_inbound_addresses",
      "mcp__thorchain-swap__get_keygen",
      "mcp__thorchain-swap__get_keygen_metric",
      "mcp__thorchain-swap__get_keysign",
      "mcp__thorchain-swap__get_keysign_pubkey",
      "mcp__thorchain-swap__get_known_pools",
      "mcp__thorchain-swap__get_lastblock",
      "mcp__thorchain-swap__get_lastblock_chain",
      "mcp__thorchain-swap__get_limit_swaps",
      "mcp__thorchain-swap__get_limit_swaps_summary",
      "mcp__thorchain-swap__get_liquidity_history",
      "mcp__thorchain-swap__get_lp_position",
      "mcp__thorchain-swap__get_members",
      "mcp__thorchain-swap__get_midgard_balance",
      "mcp__thorchain-swap__get_midgard_member",
      "mcp__thorchain-swap__get_midgard_nodes",
      "mcp__thorchain-swap__get_midgard_stats",
      "mcp__thorchain-swap__get_mimir",
      "mcp__thorchain-swap__get_mimir_admin",
      "mcp__thorchain-swap__get_mimir_key",
      "mcp__thorchain-swap__get_mimir_node",
      "mcp__thorchain-swap__get_network_info",
      "mcp__thorchain-swap__get_network_summary",
      "mcp__thorchain-swap__get_node",
      "mcp__thorchain-swap__get_oracle_price",
      "mcp__thorchain-swap__get_oracle_prices",
      "mcp__thorchain-swap__get_outbound_fee_asset",
      "mcp__thorchain-swap__get_outbound_fees",
      "mcp__thorchain-swap__get_outbound_queue",
      "mcp__thorchain-swap__get_pool",
      "mcp__thorchain-swap__get_pool_slip",
      "mcp__thorchain-swap__get_pool_stats",
      "mcp__thorchain-swap__get_queue",
      "mcp__thorchain-swap__get_ragnarok",
      "mcp__thorchain-swap__get_reference_memo",
      "mcp__thorchain-swap__get_reference_memo_by_hash",
      "mcp__thorchain-swap__get_rune_history",
      "mcp__thorchain-swap__get_rune_pool",
      "mcp__thorchain-swap__get_rune_price_history",
      "mcp__thorchain-swap__get_rune_provider",
      "mcp__thorchain-swap__get_runepool_member",
      "mcp__thorchain-swap__get_scheduled_queue",
      "mcp__thorchain-swap__get_stable_reserve",
      "mcp__thorchain-swap__get_stable_reserve_contributor",
      "mcp__thorchain-swap__get_streaming_swap",
      "mcp__thorchain-swap__get_swap_details",
      "mcp__thorchain-swap__get_swap_history",
      "mcp__thorchain-swap__get_swap_queue",
      "mcp__thorchain-swap__get_swapper_clout",
      "mcp__thorchain-swap__get_tcy_claimer",
      "mcp__thorchain-swap__get_tcy_distribution",
      "mcp__thorchain-swap__get_tcy_staker",
      "mcp__thorchain-swap__get_thorname",
      "mcp__thorchain-swap__get_thorname_owner",
      "mcp__thorchain-swap__get_trade_account",
      "mcp__thorchain-swap__get_trade_unit",
      "mcp__thorchain-swap__get_tss_metrics",
      "mcp__thorchain-swap__get_tvl_history",
      "mcp__thorchain-swap__get_tx",
      "mcp__thorchain-swap__get_tx_details",
      "mcp__thorchain-swap__get_tx_stages",
      "mcp__thorchain-swap__get_tx_status",
      "mcp__thorchain-swap__get_upgrade_proposal",
      "mcp__thorchain-swap__get_upgrade_votes",
      "mcp__thorchain-swap__get_vault",
      "mcp__thorchain-swap__get_vault_pubkeys",
      "mcp__thorchain-swap__get_vault_solvency",
      "mcp__thorchain-swap__get_version",
      "mcp__thorchain-swap__get_votes",
      "mcp__thorchain-swap__list_asgard_vaults",
      "mcp__thorchain-swap__list_derived_pools",
      "mcp__thorchain-swap__list_invariants",
      "mcp__thorchain-swap__list_liquidity_providers",
      "mcp__thorchain-swap__list_mimir_node_votes",
      "mcp__thorchain-swap__list_nodes",
      "mcp__thorchain-swap__list_pool_slips",
      "mcp__thorchain-swap__list_pools",
      "mcp__thorchain-swap__list_rune_providers",
      "mcp__thorchain-swap__list_streaming_swaps",
      "mcp__thorchain-swap__list_tcy_claimers",
      "mcp__thorchain-swap__list_tcy_stakers",
      "mcp__thorchain-swap__list_trade_accounts",
      "mcp__thorchain-swap__list_trade_units",
      "mcp__thorchain-swap__list_upgrade_proposals",
      "mcp__thorchain-swap__lookup_thorname",
      "mcp__thorchain-swap__ping",
      "mcp__thorchain-swap__quote_limit",
      "mcp__thorchain-swap__reverse_lookup_thorname",
      "mcp__thorchain-swap__search_cometbft_tx",
      "mcp__thorchain-swap__search_cosmos_txs"
    ],
    "ask": [
      "mcp__thorchain-swap__check_reference_memo",
      "mcp__thorchain-swap__get_invariant",
      "mcp__thorchain-swap__prepare_swap",
      "mcp__thorchain-swap__quote_swap"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as thorchain-swap. Review it before you use it.