Skip to main content

RPC Diagnostic Agent

Diagnose RPC connectivity, method support, and response health for any chain.

MCP tools

  • gateway_get_supported_chains
  • gateway_get_supported_methods
  • gateway_execute_rpc

Steps

  1. Confirm the chain is supported via gateway_get_supported_chains.
  2. Confirm the method exists via gateway_get_supported_methods.
  3. Call gateway_execute_rpc and report timing, response code, and any error envelope.

Agent trace

The call sequence an MCP-capable agent logs when it runs this workflow.

  1. Discover supported chains 
    mcp.tatumio.gateway_get_supported_chains()
// → [ { id: "ethereum-mainnet", ... }, ... ]
  2. List methods for the target chain 
    mcp.tatumio.gateway_get_supported_methods({
  chain: "ethereum-mainnet"
})
// → [ "eth_blockNumber", "eth_call", ... ]
  3. Execute the diagnostic RPC 
    mcp.tatumio.gateway_execute_rpc({
  chain:  "ethereum-mainnet",
  method: "eth_blockNumber",
  params: []
})
// → { result: "0x141f4ab" }

Possible failures

  • Method not supported on the chain
  • Rate-limit / quota exhaustion
  • Network partition / endpoint downtime

Recovery guidance

  • Confirm the method against `gateway_get_supported_methods` before calling
  • Backoff with jitter on 429; never spin
  • Re-route via `gateway_execute_rpc` (managed gateway handles failover)