SUI MCP Server

A TypeScript MCP server for interacting with the SUI blockchain via CLI.

Network: Testnet (default)

Tools

Tool	Description
sui_active_address	Get current active SUI address
sui_balance	Get SUI balance for an address
sui_objects	Get all objects owned by an address
sui_get_object	Get details of a specific object
sui_call	Call a Move function on a smart contract
sui_publish	Publish a Move package
sui_transfer_object	Transfer an object to another address
sui_faucet	Request test SUI from faucet
sui_network	Get current network environment
sui_addresses	List all addresses in wallet
sui_transaction	Get transaction details by ID
sui_gas	Get gas objects for an address

Setup

npm install

Make sure SUI CLI is installed:

curl -fsSL https://docs.sui.io/guides/install | sh

Set up testnet:

sui client new-env --alias testnet --rpc https://fullnode.testnet.sui.io:443
sui client switch --env testnet

Running

npm run build
npm start

opencode Integration

Add to your opencode.jsonc:

{
  "mcp": {
    "sui": {
      "type": "local",
      "command": ["node", "YOUR_MCP_SERVER_PATH"]
    }
  }
}

Claude

Add to your .mcp.json:

{
  "mcpServers": {
    "sui": {
      "type": "stdio",
      "command": "node",
      "args": ["YOUR_MCP_SERVER_PATH"]
    }
  }
}

Usage

Call a Move function

sui_call({
  package: "YOUR_PACKAGE_ID",
  module: "YOUR_MODULE_NAME",
  function: "FUNCTION_NAME",
  typeArgs: "YOUR_TOKEN_TYPE",
  args: "ARG1,ARG2",
  gasBudget: "50000000"
})

Get objects for an address

sui_objects({ address: "YOUR_ADDRESS" })

Get object details

sui_get_object({ objectId: "YOUR_OBJECT_ID" })

Publish a package

sui_publish({
  packagePath: "YOUR_PACKAGE_PATH",
  gasBudget: "100000000"
})

Transfer an object

sui_transfer_object({
  objectId: "YOUR_OBJECT_ID",
  to: "RECIPIENT_ADDRESS",
  gasBudget: "50000000"
})

Tips

• Gas Budget: Default is 0.05 SUI (50000000 MIST). Increase for complex transactions.
• Object IDs: Must be in format 0x... (66 chars)
• Clock Object: Use 0x6 for the Clock object on testnet
• Type Arguments: For custom tokens, use the full type: 0xTOKEN_ADDRESS::coin::COIN