Ankr Agent RPC

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Read chain data on 200+ networks and Sui: transactions, logs, balances, objects, ABI-decoded.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Ankr Agent RPC": {
      "url": "https://mcp.ankr.com/rpc",
      "transport": "streamable-http"
    }
  }
}

Measured tools (25)

• getAccountBalance read-only

  Balance of an account across many blockchains, by 0x address or ENS name, via the Ankr Advanced API indexer. Assets are ranked by USD value descending and only the top 20 are listed by default (a real wallet can hold 1000+ assets, over half of them priced at $0); tune that with maxTokens/minUsd, or call getBalances for structured JSON. Anything the indexer PRICED at zero or below minUsd is summarised as a dust count instead of being listed. An asset with NO indexer price is not dust: it reads "USD value unknown" and ranks after every priced asset, so on a wallet holding more priced assets than maxTokens none appear here and the note says how many exist off-page. Unknown is not zero. An implausibly large raw balance (typical of scam tokens minting max-uint) is flagged and its balance is withheld; never add it to a total. Each line names the chain the asset is held on, which matters because omitting `blockchains` queries EVERY chain and interleaves the result across them.

  Parameters:

  • address (required) — string — Wallet address (0x...) or ENS name (*.eth)
  • minUsd — number — Only list assets worth at least this many USD; the rest are summarised as dust.
  • maxTokens — integer — Max assets to list, sorted by USD value descending (default 20, max 100).
  • blockchains — array — Chains to query; omit to query every chain

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getTokenPrice read-only

  USD price of a token on one blockchain: pass a contract address for an ERC-20, or leave it empty for the native coin. Returns { chain, asset, usd, priced_via_contract, as_of: { timestamp, blockNumber, lag, status } }. Read as_of before reporting a price; it says how stale the indexer's view is. A native-coin query is priced from the WRAPPED token, which is why priced_via_contract is a wrapped-token address rather than the coin itself.

  Parameters:

  • chain — string — Chain slug, e.g. eth, bsc, polygon.
  • blockchain — string — DEPRECATED alias for `chain`. Use `chain`.
  • contractAddress — string — Contract address of the token. Leave empty for native coin.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getTransaction read-only

  Get a transaction by its hash on one blockchain, with tier-2 decoding requested. Check tier_degraded before reading `function` or `args`. By default the receipt is fetched too (status, gas used, decoded logs). Set include to "transaction" to skip it and halve the cost. Tier-2 field names: tx, block, block_hash, from, to, value, gas_limit, gas_price, gas_used, status ("success"|"failed"), function, args (named object), logs[] ({ contract, event, args } when decoded, else { address, topics, data, _event_unknown }). All numeric values are decimal strings and all addresses are EIP-55 checksummed. Sui: pass the digest; `include` is ignored.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • txHash (required) — string — Transaction hash (0x + 64 hex) or Sui digest
  • include — string — Which parts to fetch. "all" (default) returns both the transaction and the receipt; "transaction" returns only eth_getTransactionByHash; "receipt" returns only eth_getTransactionReceipt.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getLogs read-only

  Event logs on one chain, filtered by address and/or topics over a block range. Tier 2 emits each log as { contract, event, args }, dropping logsBloom and per-log block duplication; an undecodable one stays raw as { address, topics, data, _event_unknown }. Check tier_degraded before reading `event` or `args`. With both bounds concrete block NUMBERS (toBlock may be omitted/"latest") the range is walked in ascending chunks, stopping once the display cap fills: the reply says `range_fully_scanned: false`, carries a cursor, and `note` says why. `more_available` means more logs were seen than shown; `full_count` appears only when the whole range was scanned. Any other bound is ONE unbounded eth_getLogs: no chunking, no cursor, liable to tier 0. Sui: Move events over a CHECKPOINT range. fromBlock is required; `address` is the emitting package[::module]; eventType and sender narrow it; `topics` is refused, not ignored. Same body; rows add checkpoint/digest/index.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • sender — string — Sui: the emitting transaction's sender, 0x + 64 hex
  • topics — array — Topic filters (0x + 64 hex, or null to wildcard); topics[0] is the event signature hash. Max 4 slots.
  • address — string — Emitting contract; Sui: package[::module]
  • maxLogs — integer — Max logs to DISPLAY (default 50, max 1000). The scan stops once this is filled, so it also bounds how much is fetched upstream.
  • toBlock — To block: decimal, 0x-hex, or tag (default latest)
  • eventType — string — Sui: Move event type 0xpkg::module::Name
  • fromBlock — From block: decimal, 0x-hex, or tag (default latest)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getBlock read-only

  Get a block by a 0x-64 hash, a block number (decimal or 0x-hex), or a tag (latest, finalized, safe, earliest, pending). Tier 2 drops the verbose header roots and bloom and, with includeTxs, ABI-decodes and compacts the embedded transactions. A large block with includeTxs may come back raw (hex); _meta.tier says which, and dropping includeTxs gets the header decoded. Sui: `block` is a checkpoint number or digest.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • block (required) — Block number (decimal or 0x-hex), a 0x-64 block hash, or a tag. Above 2^53 pass a STRING — a JSON number that large is not exact.
  • includeTxs — boolean — Include full (decoded) transactions instead of just hashes (default false)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getBalances read-only

  An address's balances on ONE chain: native via eth_getBalance plus, by default, ERC-20 balances with USD from the Ankr Advanced API indexer (tier 0). ENS resolves for the token lookup only; a raw-RPC-only chain returns native alone. Tokens rank by USD descending, top 20 by default; tune with maxTokens/minUsd. Anything PRICED at zero or below minUsd goes to `dust` (count + USD total); `full_count` is how many assets exist. UNPRICED assets are not dust: usd: null, unpriced: true, ranked after every priced one, counted by `unpriced_on_page`/`unpriced_total`, never summed. A raw balance >=2^128 is `implausible: true`, formatted balance WITHHELD. Sui: none of that applies. Balances come from the node, RAW in base units; `decimals`/`symbol` only where the coin publishes metadata (first 10 types). No USD, dust or ENS; `native` is SUI, maxTokens caps the token rows, minUsd/includeTokens do nothing.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • address (required) — string — Address (0x...) or ENS name
  • minUsd — number — Only list tokens worth at least this many USD; everything below is bucketed into `dust`. Defaults to excluding only exactly-zero-value tokens.
  • maxTokens — integer — Max entries in `tokens` (default 20, max 100). EVM ranks them by USD, tail behind the cursor, and counts the native coin as one of them (repeating `native`); Sui does not, so all are other coin types.
  • includeTokens — boolean — Include ERC-20 token balances via AAPI (default true)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getWalletActivity read-only

  An address's recent transactions on one blockchain, newest first, via the Ankr Advanced API indexer. Items are returned under `activity`, exactly once per page, on this first page and on every continuation alike. There is no second alias key. Each item: hash, from, to, value_wei (decimal string, RAW WEI, not ether and not token units), block (decimal), time { unix_seconds, iso }, status ("success"/"failed"), and selector (the raw 4-byte function selector, e.g. "0xa9059cbb"). The selector is NOT a resolved function name: this indexer does not return one, and mapping a selector to a name needs a signature registry this server does not have. A field is omitted rather than guessed when the upstream value is missing. `time.unix_seconds` is always the authoritative value; `time.iso` is present ONLY when the timestamp is a real calendar instant, and otherwise `time.iso_unavailable` says why, so new Date(time.iso) never yields an Invalid Date. Sui: transactions SENT BY the address.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • address (required) — string — Wallet address (0x...) or ENS name
  • pageSize — integer — Items per page (default 25, max 100)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• resolveContract read-only

  Inspect an address on a chain: whether it is a contract, best-effort ERC-20 token metadata (name, symbol, decimals), and EIP-1967 proxy detection (implementation address). Built from eth_getCode / eth_call / eth_getStorageAt, which are plain JSON-RPC passthrough. The metadata is best-effort and may be absent on a non-standard contract.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • address (required) — string — Contract or account address

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• searchChain read-only

  Resolve an on-chain IDENTIFIER to the object it names. Accepts exactly THREE shapes, and nothing else: - 0x + 64 hex -> transaction (falls back to block hash if there is no such tx) - 0x + 40 hex -> address (reports contract vs EOA) - all digits -> block number NOT SUPPORTED: ticker symbols, token or contract NAMES, labels, or any other free-form text. "USDC", "uniswap" and "the biggest holder" all return kind:"unknown" with a note, because that needs a label registry this server does not have. ENS names (*.eth) are also NOT resolved; they return kind:"ens" with a note. Do not call this tool to look up an asset by name; get the contract address another way first. A transaction or block resolution requests tier-2 decoding; an address lookup is passthrough. Defaults to eth when no chain is given.

  Parameters:

  • query (required) — string — 0x tx/block hash, 0x address, or block number. ENS names are NOT resolved: they come back as kind:"ens" with a note.
  • chain — string — Chain (default eth)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• expandResult read-only

  Continue a paged result using the opaque cursor returned by a previous tool call. Supported cursor sources: getWalletActivity, getLogs (a block range, or a Sui checkpoint scan), getBalances (asset offset), Sui views (tier 0 re-reads the view unshaped: a fresh upstream call, never a replay of the earlier answer). Returns the next page of compact items plus a new cursor if more remains.

  Parameters:

  • cursor (required) — string — The opaque cursor string from a previous tool result

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• rpcCall read-only

  Call ANY JSON-RPC method on a supported chain: the escape hatch beyond the routed tools (eth_call, eth_estimateGas, eth_getCode, debug_trace*, trace_*). Prefer getTransaction/getLogs/getBlock where they fit. TORPC tier is negotiated per call (contract 2); check _meta.tier. This is a read/data tool, never a wallet. It REFUSES anything that would change state, on every chain family: transaction broadcast and signing (eth_sendRawTransaction, MEV bundle/private-tx, personal_*/eth_sign*, Solana sendTransaction/requestAirdrop, BTC sendrawtransaction and bumpfee/psbtbumpfee, Sui sui_executeTransactionBlock, XRPL submit, Tron broadcasttransaction/createtransaction/triggersmartcontract, Cosmos broadcast_tx_*); transaction BUILDING, which returns an unsigned transaction rather than sending one (Sui's unsafe_* namespace); node administration and dev-node state (admin_*, miner_*, personal_*, hardhat_*, anvil_*, evm_*, engine_*); any mutating verb (set*, write*, start*, stop*, compact*), which refuses settxfee, debug_setHead and debug_writeBlockProfile; the node-operation half of geth's debug namespace (profilers, chaindb compaction, file-writing traces), which the verb rule cannot reach when the mutating word sits mid-camelCase; bitcoind's node and wallet state controls (invalidateblock, reconsiderblock, preciousblock, pruneblockchain, rescanblockchain, abortrescan, generateblock); and, on dot-namespaced chains, mempool submission and the node's own wallet, multisig and administration families (Filecoin.MpoolPush, Filecoin.WalletExport). Sign and send with your own wallet or signer. On sui this tool speaks gRPC, not JSON-RPC: a bridged method is answered there, any other is REFUSED rather than sent to Sui's JSON-RPC, which Sui removes in mid-October 2026. describeMethods says which are bridged. Everything else is FORWARDED: this tool keeps no list of permitted reads, because which methods exist is decided per chain by the endpoint's blockchain schema and what you may call by your tenant. A forwarded read can still come back refused ("Method disabled, reason: restricted by blockchain schema") — that is the authoritative answer. Call listChains for coverage.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • method (required) — string — JSON-RPC method, e.g. eth_call, eth_estimateGas, Filecoin.ChainHead
  • tier — number — Requested TORPC tier (default 2)
  • params — array — Positional JSON-RPC params (default [])

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiGetObjects read-only

  Move objects by id, in ONE batch call: each answer carries the object's id, type, version, owner and its decoded Move fields under json. Up to 50 ids per request and nothing is trimmed from the reply, so no cursor is issued. An id the node cannot serve is reported POSITIONALLY under failed, with its request index, the id asked for and the gRPC status, never dropped in silence. Reads only.

  Parameters:

  • ids (required) — array — Object ids to read, 50 at most. Order is preserved and a failure keeps its position.
  • version — string — Read this past version instead of the live object. A decimal string, because an object version is a u64. Single id only.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiListOwnedObjects read-only

  Every object an address owns, page by page, out of the node's own owner index. Narrow it with type: a bare Move type such as 0x2::coin::Coin matches any type parameter, while a fully applied one matches only that instantiation. A page holds 50 entries by default and 200 at most; when the node holds more, an opaque cursor comes back and expandResult returns the following page in this same shape. Reads only.

  Parameters:

  • owner (required) — string — The owning address.
  • type — string — Move type filter, with or without its type parameters. Omit to list every owned object.
  • pageSize — integer — How many objects to return (default 50, max 200). The tail is reachable through the returned cursor.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiListDynamicFields read-only

  Whatever a Move package stored under one object's UID: tables, bags and dynamic object fields, listed from the parent id. A row names the field's own object id, its kind, the name it is keyed by and the Move type of its value. The value itself is a BCS blob and is left out of this answer; hand that field id to suiGetObjects and it comes back decoded. 50 rows unless asked otherwise and 200 at the outside, with a cursor for as long as the parent has more. Reads only.

  Parameters:

  • parent (required) — string — The id of the object whose dynamic fields are listed.
  • pageSize — integer — How many fields to return (default 50, max 200). The tail is reachable through the returned cursor.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiGetPackage read-only

  What a published Move package declares, so a caller can pick what to inspect next. By default this answers with an INDEX: one row per module carrying its name and how many functions and datatypes it holds, capped at 50 rows (raise it with maxModules). Pass `module` to get that one module in full instead — every function signature and every datatype it declares. The whole package is never returned; the 0x2 framework alone is around 484 KB. This method has no upstream paging, so a truncated index carries no cursor: the way past the cap is maxModules, then `module`, then suiGetFunction for a single signature. Repeated addresses arrive as `$n`/`@n` handles, resolved by the ids and packages tables beside them.

  Parameters:

  • package (required) — string — Package id (0x2 is the framework)
  • module — string — One module to return in full
  • maxModules — integer — Rows the index lists before it truncates (default 50). Ignored when `module` is given.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiGetFunction read-only

  One Move function's signature: visibility, whether it is an entry function, its type parameters, its parameter types and its return types — what a programmable transaction block needs in order to call it. Never capped or paged. Take the package and module names from suiGetPackage. A name the package does not declare is refused by the node rather than approximated.

  Parameters:

  • package (required) — string — Package id (0x2 is the framework)
  • module (required) — string — Module name
  • function (required) — string — Function name

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiResolveName read-only

  Resolve a SuiNS name (something.sui) to the address it points at, or an address back to its name. Give exactly one of `name` or `address`. READ `status` BEFORE the record. It is one of: resolved, the registration is live and the record is good; expired, the registration lapsed and the record — target address included — is returned but must not be trusted as a destination; no_target_address, the name is registered and points nowhere; not_registered, the registry holds no record. All four are answers, not errors. Reverse is NOT the inverse: an address answers with its OWN default name, which need not be a name pointing at it. One record comes back, so nothing is capped, truncated or paged. Only .sui names.

  Parameters:

  • name — string — Forward: a .sui name
  • address — string — Reverse: a Sui address

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiSimulateTransaction read-only

  Run a transaction against current state and report what it WOULD do, without submitting it: whether it succeeds or which Move abort stops it and in which command, the gas it consumes, the objects it creates, mutates and deletes, the balance changes per address and coin, each command's return values decoded, and any events it would emit. Takes the base64 BCS TransactionData your wallet or SDK produces — the same argument sui_dryRunTransactionBlock takes; no signature, and none is accepted. Nothing is broadcast: this server cannot reach Sui's execute rpc at all. `cursor` re-runs it unshaped through expandResult. Reads only.

  Parameters:

  • transactionBytes (required) — string — The transaction to simulate: a base64 BCS TransactionData.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• suiWatchEvents read-only

  Follow Move events from now on, by POLLING — nothing is pushed. This first call only establishes a start position: it reads the executed tip from a Sui event subscription, returns NO events, and hands back a cursor. Each expandResult on that cursor lists what has been emitted since and returns the next one, so no event falls in the gap between two polls. That is the whole difference from getLogs, which scans a checkpoint range you name and cannot resume across calls. Filter by address (the emitting package[::module]), eventType and sender; rows and body keys are getLogs'. Sui executes about 4 checkpoints a second, so poll on that scale; `more_available: true` means the cap was already full, so poll again at once. 50 events a poll unless asked otherwise, 1000 at the outside. Reads only.

  Parameters:

  • sender — string — The emitting transaction's sender, 0x + 64 hex
  • address — string — Emitting Move code: package, or package::module
  • maxLogs — integer — Max events to DISPLAY per poll (default 50, max 1000).
  • eventType — string — Move event type 0xpkg::module::Name

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getNFTs read-only

  NFTs one wallet holds on one chain: collection, name, token id, contract, standard (ERC721/1155), image URL. For fungible tokens use getBalances.

  Parameters:

  • chain (required) — string — Chain, from listChains aapiChains
  • address (required) — string — Owner wallet address (0x...) or ENS name
  • pageSize — integer — Items per page (default 20, max 50)
  • pageToken — string — nextPageToken from the previous page

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getTokenHolders read-only

  Who holds an ERC-20 token on one chain, largest balance first, plus the total holder count. `balance` already has decimals applied, so do not divide it again. For one wallet's tokens use getBalances.

  Parameters:

  • chain (required) — string — Chain, from listChains aapiChains
  • contractAddress (required) — string — ERC-20 token contract address
  • pageSize — integer — Holders per page (default 20)
  • pageToken — string — nextPageToken from the previous page

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getTokenPriceHistory read-only

  Historical USD price series for a token contract on a chain, via the Ankr Advanced API indexer: a list of { timestamp, usd, block } quotes. `limit_applied` reports the cap the call was actually made with (default 100, max 1000). When `count` reaches that cap the response sets `possibly_truncated: true`: this endpoint returns NO continuation token, so a clipped series and a series that simply ends are indistinguishable, and there is no cursor to page with. Treat such a series as incomplete-of-unknown-length rather than the full history; raise `limit` or walk `fromTimestamp`/`toTimestamp` yourself.

  Parameters:

  • chain (required) — string — Chain, from listChains aapiChains
  • contractAddress (required) — string — ERC-20 token contract address
  • limit — integer — Max quotes (default 100)
  • interval — integer — Interval between quotes, in seconds
  • toTimestamp — integer — End UNIX timestamp (seconds)
  • fromTimestamp — integer — Start UNIX timestamp (seconds)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• getInteractions read-only

  List the blockchains an address has interacted with, via the Ankr Advanced API indexer. Cross-chain, so there is no chain argument. Useful as a first step before fetching balances or activity per chain.

  Parameters:

  • address (required) — string — Address (0x...) or ENS name

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• listChains read-only

  Which chains each tool family reaches. aapiChains is where the indexer tools work (getAccountBalance, getWalletActivity, getNFTs, getTokenHolders, getTokenPrice, getTokenPriceHistory); call this before one of them on an unfamiliar chain. suiChains are answered over gRPC, by the sui* tools and the generic tools the reply's suiNote names. Raw-RPC tools (getTransaction, getLogs, getBlock) and rpcCall are not limited to these lists: they take any rpc.ankr.com/<chain> slug, 200+ chains. Each reply reports how it was shaped in _meta.tier and _meta.tier_source.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• describeMethods read-only

  What a JSON-RPC method takes, and whether this key can actually call it on this chain. Returns the positional param shape and a worked example for every method rpcCall can validate, plus rpcCall's own verdict (permitted, or refused as a write path). Pass probe:true with an explicit methods list (max 12) to also ask the node, so served reflects your key, your tenant and the chain's blockchain schema instead of a guess: yes, no, restricted, or unknown. A refused method is never sent. Without methods it returns the whole catalogue and does not probe. The catalogue is SHAPE guidance, not a coverage list: a method missing from it may still be served, and the chain's schema is the authority.

  Parameters:

  • chain (required) — string — Chain slug as in rpc.ankr.com/<chain> — any chain Ankr serves (see listChains)
  • probe — boolean — Ask the node whether each method is served (needs methods)
  • methods — array — Methods to describe (max 12); omit for the whole catalogue

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.