protogrid

Search / org.thorchain/thorchain-mcp

THORChain MCP

R0· no sign-in

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

v1.1.0 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality85good
Trust100of 100
Uptime, 30 days100%
Latency p50318 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "thorchain-mcp": {
      "type": "http",
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}
claude mcp add --transport http thorchain-mcp https://mcp.thorchain.org/mcp
[mcp_servers.thorchain-mcp]
url = "https://mcp.thorchain.org/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "thorchain-mcp": {
      "type": "remote",
      "url": "https://mcp.thorchain.org/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "thorchain-mcp": {
      "type": "http",
      "url": "https://mcp.thorchain.org/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=thorchain-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnRob3JjaGFpbi5vcmcvbWNwIn0%3D"
}
{
  "servers": {
    "thorchain-mcp": {
      "type": "http",
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}
{
  "mcpServers": {
    "thorchain-mcp": {
      "httpUrl": "https://mcp.thorchain.org/mcp"
    }
  }
}
extensions:
  "thorchain-mcp":
    enabled: true
    name: "thorchain-mcp"
    type: streamable_http
    uri: "https://mcp.thorchain.org/mcp"
    timeout: 300

Quality 85 / 100good

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations16 of 16 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 2,315 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
  • pass
    tools.hidden_textno hidden text in tool names, descriptions, schemas or annotations
stability50 · weight 15
  • warn
    stability.changes127 tool changes in 30 days
  • fail
    stability.rug_pull3 tools kept their name but changed most of their description in 30 days; review before trusting them
  • pass
    stability.new_linksno tool change named a new site
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

16 tools, about 2,315 tokens to load them all · tool set a3c01c705108 · tools last changed 2026-11-04 · checked 2026-11-14 06:30 UTC

Tool changes

  • get_tvl_historyremoved

    Returns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.

  • get_thorname_ownerremoved

    Returns THORNames owned by an address.

  • get_thornameremoved

    Returns THORName registration information including owner, expiry, and registered chain addresses. THORNames are human-readable aliases for blockchain addresses.

  • get_rune_historyremoved

    Returns historical RUNE data including price over time intervals.

  • get_mimir_noderemoved

    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.

  • get_vaultremoved

    Returns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.

  • get_swapper_cloutremoved

    Returns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.

  • get_outbound_queueremoved

    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.

  • get_noderemoved

    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.

  • get_network_inforemoved

    Returns THORChain network statistics and health information including bond metrics, pool data, and node counts.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 100 / 100

provenance100
liveness100
freshness100
hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% +updated-9d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.thorchain.org/mcp streamable-httpnoneyes100%318 ms2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-052026-11-14

Tools (16)

check_reference_memoread-onlyPre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.
get_inbound_addressesread-onlyReturns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.
get_lastblockread-onlyReturns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.
get_network_summaryread-onlyCompact THORChain network status for agents: node counts, bonding/liquidity APY, reserve, pooled RUNE, next churn height, vault migration flag. Prefer this over get_network_info (full toolset only), which returns large per-node bond arrays.
get_outbound_feesread-onlyReturns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.
get_poolread-onlyReturns one liquidity pool by asset (e.g. BTC.BTC): depths, units, status and price. Use list_pools to find asset identifiers and get_pool_stats for volume, fees and APY.
get_pool_statsread-onlyReturns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.
get_swap_statusread-onlyAnswers "did my swap go through?" in plain terms. Returns a status (not_found, pending, streaming, sent, refunded, completed), whether it is done, a one-line summary to tell the user, streaming progress, an estimated wait, and the refund reason. refund=true with status sent means part was refunded. Start here for swap tracking; use get_tx_status only for raw stage detail.
get_txread-onlyReturns the observed transaction for a hash (inbound or outbound): chain, addresses, coins, memo and the heights THORChain saw it at. For "did my swap go through?" use get_swap_status.
get_tx_statusread-onlyReturns THORNode's raw status for an inbound transaction: every processing stage, planned outbounds and sent outbounds. For a plain answer (pending, streaming, sent, refunded) use get_swap_status; use this for stage-level detail.
list_poolsread-onlyReturns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.
lookup_thornameread-onlyReturns THORName details including chain addresses, expiry, and owner.
pingread-onlyHealth check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.
prepare_swapread-onlyBuild 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.
quote_limitread-onlyGet a limit order quote with expected output, expiry time, and a generated memo for executing the limit order. Limit orders execute when the target price is reached. For an immediate market swap use quote_swap.
quote_swapread-onlyCalculate 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "org.thorchain/thorchain-mcp",
  "title": "THORChain MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.thorchain.org/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.1.0",
  "repository": {
    "url": "https://gitlab.com/thorchain/thorchain-mcp",
    "source": "gitlab"
  },
  "websiteUrl": "https://gitlab.com/thorchain/thorchain-mcp",
  "description": "THORChain swap quotes, non-custodial swap prep, swap status, pools and network data."
}