Skip to content
sui-mcp

Objects

Tool Summary
get_object Get a Sui object by its ID.
list_dynamic_fields List dynamic fields of a Sui object.
list_owned_objects List raw objects owned by a Sui address with optional type filter and pagination.

get_object

Section titled “get_object”
  • Title: Get object
  • Profile: core (default)
  • Annotations: openWorldHint: true, readOnlyHint: true
  • Metadata: anthropic/maxResultSizeChars: 500000

Get a Sui object by its ID. Returns type, owner, version, content (JSON), and digest. Automatically extracts display metadata (name, description, image_url) for NFTs. For the LATEST version it also lists address_balances (funds the object holds in its own address balance, which are not among its fields and which only its defining module can withdraw) and, for a kiosk, kiosk_cap_holder: who actually controls it today, since content.owner is self-declared and not kept in sync with the KioskOwnerCap transfer that does. Neither is read for a specific version: both are current state and would misname a past snapshot’s controller.

Parameter Type Required Description
object_id string yes The object ID (0x…)
version string no Specific version to fetch
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’

list_dynamic_fields

Section titled “list_dynamic_fields”
  • Title: List dynamic fields
  • Profile: developer
  • Annotations: openWorldHint: true, readOnlyHint: true

(Developer) List dynamic fields of a Sui object. Returns field names, types, and values. Useful for inspecting on-chain tables, kiosk contents, or other dynamic collections.

Parameter Type Required Description
parent_id string yes Parent object ID (0x…)
limit integer (1 to 1000) no Max results (default 50, max 1000)
cursor string no Pagination cursor from previous response
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’

list_owned_objects

Section titled “list_owned_objects”
  • Title: List owned objects
  • Profile: core (default)
  • Annotations: openWorldHint: true, readOnlyHint: true

List raw objects owned by a Sui address with optional type filter and pagination. count covers every object of the page; the default view lists the objects that fit about 30k characters in page order and states the rest under omitted, and detail: 'full' lists the whole page. next_cursor continues after the whole page, rows under omitted included. For NFTs specifically, prefer list_nfts (resolves kiosk storage, extracts display metadata). For a wallet summary, prefer get_wallet_overview.

Parameter Type Required Description
owner string no Owner address (0x…). Required; address is accepted in its place.
address string no Alias for owner.
object_type string no Filter by object type (e.g. 0x2::coin::Coin<0x2::sui::SUI>)
limit integer (1 to 1000) no Max results (default 50, max 1000)
cursor string no Pagination cursor from previous response
detail summary | full no ‘summary’ (default): the page’s objects that fit about 30k characters, the rest in omitted. ‘full’: the whole page.
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’