Fetch a Sui object's current state by object id. Returns the object's owner, type, version, digest, previous-transaction pointer, and Move contents (BCS). Use for any 'what is object 0x...' question — bypass GraphQL for single-object reads. By default routes 'auto': tries the live full node, falls back to the Archival Service if live has expired this version. The trace records the fallback chain.

Fetch a transaction by its base58 digest. Returns the transaction body, effects (status, gas summary, changed objects), events, and signatures. The right tool for 'what happened in tx '. Defaults to 'auto' routing — live first, falls back to archive on retention boundary.

Fetch a checkpoint by sequence number, digest, or 'latest'. Returns the checkpoint header, summary (timestamp, networkTotalTransactions), and digest. Defaults to 'auto' routing — live first, archive fallback. For latest=true the live node is always authoritative; auto still works (archive returns its latest as a fallback if live is unreachable).

Fetch metadata for an epoch — committee, system state, first/last checkpoint, reference gas price. Use epoch='current' for the live epoch.

Fetch up to 50 objects in one round-trip. Returns per-object results (each may succeed or fail individually). Prefer this over a loop of sui_get_object when you have a known list of ids.

Fetch up to 50 transactions in one round-trip. Per-item errors do not fail the batch.

Probe a gRPC endpoint for its chain identifier, latest checkpoint, and the lowest checkpoint it still has. Useful for picking between live and archive when you don't know which side has the data you need.

Get the aggregated coin balance for an address, optionally for a specific coin type (defaults to 0x2::sui::SUI).

List all coin-type balances held by an address. Paginated.

List the objects an address owns, paginated. Each item carries object_id + version + type — fetch full bodies via sui_get_object or sui_batch_get_objects.

Get coin metadata (decimals, symbol, name, icon) for a coin type. Cacheable; metadata rarely changes.

List dynamic fields attached to a parent object. Useful when crawling tables/bags/dynamic object fields.

Get a Move package by id — its modules, ABI, dependencies, and on-chain bytecode pointer. The starting point for any 'what does this contract expose?' question.

Get the signature of a specific Move entry/public function — type parameters, argument types, return types, visibility. Use this before calling sui_simulate_transaction or constructing a PTB.

Get a Move datatype (struct or enum) definition — its fields, abilities, and type parameters.

List historical versions of a Move package — the upgrade chain. Useful when an address points at an older snapshot of a contract.

One-shot relational read for an address — balance + owned objects (first 12) + recent transactions (first 10). Replaces 4–5 separate gRPC calls. Use as the default 'tell me about this address' tool.

Lightweight 'about this network' read — chain identifier, latest checkpoint, current epoch + reference gas price. One query.

Recent checkpoint feed with digests, timestamps, and per-checkpoint transaction counts.

Walk one step backward through an object's history. Returns the prior valid version + the digest of the transaction that produced this version. Object versions are NOT a +1 monotonic counter — this tool encapsulates the canonical 'previousTransaction → effects.changedObjects.inputVersion' walk so agents don't re-implement it.

Pull transaction effects, gas summary, balance changes, and the checkpoint pointer in one GraphQL round-trip — relational reads gRPC isn't shaped for.

Run an arbitrary GraphQL query against the Sui GraphQL endpoint. The escape hatch for the agentic dispatcher pattern: when no curated tool fits, the agent crafts its own query. Use sui_graphql_introspect first if you don't know the schema. NOTE: Sui's GraphQL RPC is indexer-backed and already composes the Archival Service under the hood, so an empty/null GraphQL result usually means the indexer doesn't have the entity at the requested level — running a parallel archive query is rarely useful. The right escalation when GraphQL returns null for a known id/digest/checkpoint is to drop to sui_get_object / sui_get_transaction / sui_get_checkpoint with source='auto' (the live→archive fallback covers retention boundary cases the indexer hasn't materialized).

Introspect the Sui GraphQL schema. Returns the type system so an agent can construct a valid sui_graphql_query.

Return the catalog of gRPC services and methods this MCP server can reach (with which curated tool, if any, wraps each one). Use this when deciding whether to call a curated tool or fall back to sui_grpc_call.

Return the gRPC, GraphQL, and Archival URLs in use for a given network, after env-override resolution. Useful when deploying behind a self-hosted full node.

Escape hatch: call any READ method on the LedgerService / StateService / MovePackageService directly. Args are forwarded as-is to the @mysten/sui SuiGrpcClient. Pass read_mask_paths if you want fields populated. Use sui_describe_grpc_services first to discover what's available. ExecuteTransaction and SubscribeCheckpoints are blocked here — they have their own gated tools. For LedgerService methods, source='auto' (default) tries live then falls back to archive on retention boundary.

Subscribe to new checkpoints and return a window of up to 10 frames (or until 30s elapse, whichever comes first). Each frame carries the cursor + checkpoint summary. Call repeatedly to tail the chain — pass the last cursor back as 'after_cursor' for resumable reads.

Dry-run a transaction. Always safe — no state changes, no fees. Returns effects, command outputs, and a suggested_gas_price. Use this before any real execution to check that the tx will succeed and to size gas. Accepts BCS-encoded transaction bytes (base64).

(disabled) Submit a pre-signed transaction. Set SUI_MCP_ENABLE_EXECUTION=true on the server to enable.