expertvagabond avatar

Sui Mcp Server

expertvagabond/sui-mcp-server

This is the kitchen sink for Sui blockchain operations. It wraps the official Mysten SDK to expose 53 tools across wallets, coin transfers, object queries, Move contract introspection, staking, SuiNS name resolution, and DeFi protocols like Cetus and DeepBook. You can create wallets, execute Move calls with dev_inspect simulation, query validator sets, resolve .sui names, and pull pool data from major DEXes. Connects to public RPC nodes on mainnet, testnet, and devnet with no API key required. Reach for this when you need programmatic access to the full Sui ecosystem rather than just balance checks and simple transfers.

GitHub stars
1
tools
53
transport
STDIO
last updated
Mar 26, 2026

Tools

53 tools

Public tool metadata for what this MCP can expose to an agent.

create_walletCreate a new Ed25519 keypair (in-memory only, not persisted)

Create a new Ed25519 keypair (in-memory only, not persisted)

No parameter schema in public metadata yet.

import_walletImport from a Bech32-encoded private key (`suiprivkey...`)

Import from a Bech32-encoded private key (`suiprivkey...`)

No parameter schema in public metadata yet.

list_walletsList all wallets in the current session

List all wallets in the current session

No parameter schema in public metadata yet.

get_balanceGet SUI balance for any address

Get SUI balance for any address

No parameter schema in public metadata yet.

get_all_balancesAll coin balances for an address (SUI + other coin types)

All coin balances for an address (SUI + other coin types)

No parameter schema in public metadata yet.

get_coinsCoin objects of a specific type owned by an address

Coin objects of a specific type owned by an address

No parameter schema in public metadata yet.

get_coin_metadataMetadata for a coin type (name, symbol, decimals)

Metadata for a coin type (name, symbol, decimals)

No parameter schema in public metadata yet.

get_total_supplyTotal circulating supply of a coin type

Total circulating supply of a coin type

No parameter schema in public metadata yet.

transfer_suiTransfer SUI between addresses (amount in SUI, not MIST)

Transfer SUI between addresses (amount in SUI, not MIST)

No parameter schema in public metadata yet.

transfer_objectsTransfer one or more objects to a recipient

Transfer one or more objects to a recipient

No parameter schema in public metadata yet.

merge_coinsMerge multiple coins into one (handles gas conflicts)

Merge multiple coins into one (handles gas conflicts)

No parameter schema in public metadata yet.

split_coinsSplit a coin into multiple coins

Split a coin into multiple coins

No parameter schema in public metadata yet.

get_objectFull details of any on-chain object by ID

Full details of any on-chain object by ID

No parameter schema in public metadata yet.

get_owned_objectsObjects owned by an address with optional type filtering

Objects owned by an address with optional type filtering

No parameter schema in public metadata yet.

get_dynamic_fieldsDynamic fields of an object (tables, bags)

Dynamic fields of an object (tables, bags)

No parameter schema in public metadata yet.

multi_get_objectsBatch-fetch up to 50 objects in one call

Batch-fetch up to 50 objects in one call

No parameter schema in public metadata yet.

get_object_historyTrace all transactions that touched a given object

Trace all transactions that touched a given object

No parameter schema in public metadata yet.

get_transactionFull transaction details by digest

Full transaction details by digest

No parameter schema in public metadata yet.

dry_run_transactionDry-run to preview effects without executing

Dry-run to preview effects without executing

No parameter schema in public metadata yet.

query_transactionsSearch by sender, recipient, object, or Move function

Search by sender, recipient, object, or Move function

No parameter schema in public metadata yet.

get_total_transactionsTotal transaction count on the network

Total transaction count on the network

No parameter schema in public metadata yet.

move_callExecute a Move function call

Execute a Move function call

No parameter schema in public metadata yet.

dev_inspectSimulate a Move call without executing (no wallet needed)

Simulate a Move call without executing (no wallet needed)

No parameter schema in public metadata yet.

get_normalized_moduleFull Move module definition (functions, structs)

Full Move module definition (functions, structs)

No parameter schema in public metadata yet.

get_move_functionMove function details (params, return types, visibility)

Move function details (params, return types, visibility)

No parameter schema in public metadata yet.

get_move_structMove struct definition (fields, abilities)

Move struct definition (fields, abilities)

No parameter schema in public metadata yet.

get_package_modulesList all modules in a Move package

List all modules in a Move package

No parameter schema in public metadata yet.

get_move_call_metricsNetwork-wide Move call metrics

Network-wide Move call metrics

No parameter schema in public metadata yet.

get_stakesAll staking positions for an address

All staking positions for an address

No parameter schema in public metadata yet.

request_add_stakeStake SUI with a validator

Stake SUI with a validator

No parameter schema in public metadata yet.

request_withdraw_stakeWithdraw staked SUI

Withdraw staked SUI

No parameter schema in public metadata yet.

get_validatorsFull validator set with APY, commission, and stake amounts

Full validator set with APY, commission, and stake amounts

No parameter schema in public metadata yet.

query_eventsQuery on-chain events by type, sender, package, or digest

Query on-chain events by type, sender, package, or digest

No parameter schema in public metadata yet.

switch_networkSwitch between mainnet, testnet, devnet, localnet

Switch between mainnet, testnet, devnet, localnet

No parameter schema in public metadata yet.

get_network_infoChain ID, epoch, gas price, latest checkpoint

Chain ID, epoch, gas price, latest checkpoint

No parameter schema in public metadata yet.

get_latest_checkpointLatest checkpoint sequence number

Latest checkpoint sequence number

No parameter schema in public metadata yet.

get_reference_gas_priceCurrent reference gas price in MIST

Current reference gas price in MIST

No parameter schema in public metadata yet.

get_checkpointDetailed checkpoint data by sequence number

Detailed checkpoint data by sequence number

No parameter schema in public metadata yet.

get_epoch_infoHistorical epoch data (times, stakes, gas summaries)

Historical epoch data (times, stakes, gas summaries)

No parameter schema in public metadata yet.

get_protocol_configSui protocol configuration (limits, features)

Sui protocol configuration (limits, features)

No parameter schema in public metadata yet.

get_system_stateFull system state: epoch, validators, storage fund

Full system state: epoch, validators, storage fund

No parameter schema in public metadata yet.

get_committee_infoValidator committee info for any epoch

Validator committee info for any epoch

No parameter schema in public metadata yet.

resolve_nameResolve `example.sui` to a Sui address

Resolve `example.sui` to a Sui address

No parameter schema in public metadata yet.

resolve_addressReverse-resolve an address to SuiNS name(s)

Reverse-resolve an address to SuiNS name(s)

No parameter schema in public metadata yet.

suins_get_name_recordFull name record -- NFT ID, target, expiration, metadata

Full name record -- NFT ID, target, expiration, metadata

No parameter schema in public metadata yet.

suins_get_priceRegistration and renewal pricing by name length

Registration and renewal pricing by name length

No parameter schema in public metadata yet.

cetus_get_poolsQuery Cetus CLMM pools by coin types

Query Cetus CLMM pools by coin types

No parameter schema in public metadata yet.

cetus_get_poolDetailed pool data for a specific Cetus pool

Detailed pool data for a specific Cetus pool

No parameter schema in public metadata yet.

deepbook_get_poolDeepBook v3 order book data -- pool state and dynamic fields

DeepBook v3 order book data -- pool state and dynamic fields

No parameter schema in public metadata yet.

get_token_priceToken price by querying DeFi pool reserves

Token price by querying DeFi pool reserves

No parameter schema in public metadata yet.

swap_quoteSwap quote by simulating against a pool

Swap quote by simulating against a pool

No parameter schema in public metadata yet.

list_common_tokensCommon Sui tokens with full coin type addresses

Common Sui tokens with full coin type addresses

No parameter schema in public metadata yet.

request_faucetRequest SUI from faucet (devnet and testnet only)

Request SUI from faucet (devnet and testnet only)

No parameter schema in public metadata yet.

Sponsors

Readme

sui-mcp-server

npm version License: MIT Node Tools

The most comprehensive Sui blockchain MCP server. 53 tools with GraphQL + JSON-RPC dual transport -- wallets, DeFi (Cetus, DeepBook), SuiNS, staking, validators, Move introspection, and the full Sui RPC surface.

Competitors offer 10-15 tools for basic operations. This server covers the entire Sui ecosystem in a single package.

Install

npx sui-mcp-server

Or install globally:

npm install -g sui-mcp-server
sui-mcp-server

Configure

Add to your MCP config (claude_desktop_config.json or ~/.mcp.json):

{
  "mcpServers": {
    "sui": {
      "command": "npx",
      "args": ["-y", "sui-mcp-server"]
    }
  }
}

No API key required -- connects directly to Sui public RPC nodes.

Tools (53)

Wallet Management (4)


View the full README on GitHub

Details

Repository
github.com/expertvagabond/sui-mcp-server
Categories
Monitoring & Observability, Finance & Commerce
Package
sui-mcp-server
Transport
STDIO
Registry
MCP registry, active

More from expertvagabond

Related Monitoring & Observability MCP servers

View all
1grovs-io avatarGrovsgrovs-io/mcpManage deep links, attribution, analytics, and campaigns on Grovs — open-source Branch alternative.0stars
2deployment-io avatarDeployment.iodeployment-io/cursor-pluginDeploy apps on your cloud. Create environments, configure infrastructure, and monitor jobs.0stars
3desper avatarQuick Html Share Mcpdesper/quick-html-sharingShare AI-generated HTML from your coding agent. Unguessable URL + viewer analytics.0stars
4dingdawg avatarDingdawg Devops Agentdingdawg/dingdawg-agent-1DevOps AI. Deploy checks, incident analysis, infra audit. Learns from past failures.0stars
5dontsovcmc avatarWildberriesdontsovcmc/mcp-server-wildberriesMCP server for Wildberries Seller API — products, orders, supplies, analytics, advertising1stars
6dontsovcmc avatarYandex Market Sellerdontsovcmc/mcp-server-yandex-market-sellerMCP server for Yandex Market Partner API — orders, offers, prices, stocks, analytics1stars