cosmos_denom_search · MCP API Docs

JSON-RPC call

Paste this body into your MCP client's `tools/call` request. The `id` field is the JSON-RPC message correlator (caller-chosen, not a record identifier — set it to anything; the server echoes it back).

tools/call body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cosmos_denom_search",
    "arguments": {
      "q": "<q>",
      "network": "<network>",
      "limit": 1
    }
  }
}

Arguments

Name	Type	Required	Description
`q`	string	required	Substring to match against base/symbol/name.
`network`	string	optional	Network slug (e.g. "mainnet-thorchain"). Restricts to denoms hosted on that chain.
`limit`	integer	optional	Max results (default 50, max 200).

Copy-paste prompt samples

Drop one of these into Claude Code, n8n, or any MCP client. Your AI agent should pick this tool to answer.

Search Cosmos denoms for the symbol "RUJI".

Find every denom whose base contains "atom".

List Cosmos denoms whose name matches "stake" — limit 20.

Look up all denoms on network "mainnet-thorchain".

Example response

Illustrative shape — actual values vary.

response shape

{
  "items": [
    {
      "slug": "ruji",
      "base": "uruji",
      "symbol": "RUJI",
      "name": "Rujira",
      "display": "ruji",
      "denom_type": "wasm",
      "denom_decimal": 8,
      "canonical_asset": {
        "slug": "ruji",
        "symbol": "RUJI",
        "name": "Rujira"
      },
      "network": {
        "slug": "mainnet-thorchain",
        "name": "THORChain",
        "thorchain_symbol": "THOR"
      },
      "deprecated_at": null
    }
  ]
}

Possible errors

VALIDATION: Returned when the arguments fail the typed schema.
NOT_FOUND: Returned when the requested resource does not exist in our DB.
RATE_LIMIT: Returned when your token's credit budget is exhausted.