Sui Mcp Server

io.github.ExpertVagabondPublished by GitHub account ExpertVagabondv0.4.2Updated Oct 25, 2026

53-tool MCP server for Sui blockchain — wallets, DeFi, Move contracts, staking, SuiNS, analytics

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

A local MCP server exposing 53 tools for the Sui blockchain, letting an assistant manage wallets, transfer and stake SUI, inspect Move contracts and query chain

What you can do
Create, import and list in-memory wallets and check balances, coins and coin metadata for addresses and coin types. Transfer SUI and objects, merge and split coins. Query objects, dynamic fields, object history, transactions and on-chain events. Inspect Move packages, modules, functions and structs, and execute or dry-run Move calls. Stake and withdraw stake, list validators, and read network, epoch, checkpoint, gas and committee data. Resolve SuiNS names and prices, query Cetus and DeepBook pools, get token prices and swap quotes, and request faucet funds on devnet or testnet.
When to use it
Useful when an assistant needs to read or act on Sui chain data: checking balances and transactions, inspecting Move contracts, exploring DeFi pools and quotes, or performing transfers and staking from a session wallet. It suits Sui developers and users who want one server covering wallets, staking, SuiNS and analytics rather than several narrow ones.
Requirements
Runs locally over stdio, typically via npx sui-mcp-server or a global npm install, so Node.js and network access to Sui RPC endpoints are needed. No API key is required; it connects to public Sui nodes. It starts on devnet and can switch to mainnet, testnet, devnet or localnet.
Before you install
Tools can move funds: transfers, coin merges and splits, staking, withdrawals and Move calls execute on-chain and may spend gas. Importing a wallet requires a Bech32 private key, and created wallets exist only in memory for the session. Default network is devnet, but switching to mainnet makes actions real; dry-run or dev-inspect first. Requests go to public Sui RPC nodes.

Installation

In SourceWeft

  1. Open Sui Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npx sui-mcp-server

Or install globally:

bash
npm install -g sui-mcp-serversui-mcp-server

Configure

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

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)

ToolDescriptionKey Params
create_walletCreate a new Ed25519 keypair (in-memory only, not persisted)--
import_walletImport from a Bech32-encoded private key (suiprivkey...)privateKey
list_walletsList all wallets in the current session--
get_balanceGet SUI balance for any addressaddress

Coin Operations (4)

ToolDescriptionKey Params
get_all_balancesAll coin balances for an address (SUI + other coin types)address
get_coinsCoin objects of a specific type owned by an addressaddress, coinType
get_coin_metadataMetadata for a coin type (name, symbol, decimals)coinType
get_total_supplyTotal circulating supply of a coin typecoinType

Transfers (4)

ToolDescriptionKey Params
transfer_suiTransfer SUI between addresses (amount in SUI, not MIST)from, to, amount
transfer_objectsTransfer one or more objects to a recipientfrom, objectIds, to
merge_coinsMerge multiple coins into one (handles gas conflicts)walletName, coinType
split_coinsSplit a coin into multiple coinswalletName, coinId, amounts

Object Queries (5)

ToolDescriptionKey Params
get_objectFull details of any on-chain object by IDobjectId
get_owned_objectsObjects owned by an address with optional type filteringaddress, type
get_dynamic_fieldsDynamic fields of an object (tables, bags)parentId
multi_get_objectsBatch-fetch up to 50 objects in one callobjectIds
get_object_historyTrace all transactions that touched a given objectobjectId

Transactions (4)

ToolDescriptionKey Params
get_transactionFull transaction details by digestdigest
dry_run_transactionDry-run to preview effects without executingtxBytes
query_transactionsSearch by sender, recipient, object, or Move functionfilter
get_total_transactionsTotal transaction count on the network--

Move Smart Contracts (7)

ToolDescriptionKey Params
move_callExecute a Move function callwalletName, target, arguments
dev_inspectSimulate a Move call without executing (no wallet needed)sender, target, arguments
get_normalized_moduleFull Move module definition (functions, structs)package, module
get_move_functionMove function details (params, return types, visibility)package, module, function
get_move_structMove struct definition (fields, abilities)package, module, struct
get_package_modulesList all modules in a Move packagepackage
get_move_call_metricsNetwork-wide Move call metrics--

Staking (4)

ToolDescriptionKey Params
get_stakesAll staking positions for an addressaddress
request_add_stakeStake SUI with a validatorwalletName, amount, validator
request_withdraw_stakeWithdraw staked SUIwalletName, stakedSuiId
get_validatorsFull validator set with APY, commission, and stake amounts--

Events (1)

ToolDescriptionKey Params
query_eventsQuery on-chain events by type, sender, package, or digestfilter

Network & Analytics (9)

ToolDescriptionKey Params
switch_networkSwitch between mainnet, testnet, devnet, localnetnetwork
get_network_infoChain ID, epoch, gas price, latest checkpoint--
get_latest_checkpointLatest checkpoint sequence number--
get_reference_gas_priceCurrent reference gas price in MIST--
get_checkpointDetailed checkpoint data by sequence numbersequenceNumber
get_epoch_infoHistorical epoch data (times, stakes, gas summaries)epoch
get_protocol_configSui protocol configuration (limits, features)--
get_system_stateFull system state: epoch, validators, storage fund--
get_committee_infoValidator committee info for any epochepoch

SuiNS Name Service (4)

ToolDescriptionKey Params
resolve_nameResolve example.sui to a Sui addressname
resolve_addressReverse-resolve an address to SuiNS name(s)address
suins_get_name_recordFull name record -- NFT ID, target, expiration, metadataname
suins_get_priceRegistration and renewal pricing by name lengthlength

DeFi: Cetus DEX (2)

ToolDescriptionKey Params
cetus_get_poolsQuery Cetus CLMM pools by coin typescoinTypeA, coinTypeB
cetus_get_poolDetailed pool data for a specific Cetus poolpoolId

DeFi: DeepBook (1)

ToolDescriptionKey Params
deepbook_get_poolDeepBook v3 order book data -- pool state and dynamic fieldspoolId

DeFi: Token Tools (3)

ToolDescriptionKey Params
get_token_priceToken price by querying DeFi pool reservestoken
swap_quoteSwap quote by simulating against a pooltokenIn, tokenOut, amount
list_common_tokensCommon Sui tokens with full coin type addresses--

Faucet (1)

ToolDescriptionKey Params
request_faucetRequest SUI from faucet (devnet and testnet only)address

Why This One?

  • 53 tools vs 10-15. Competitors like 0xdwong/sui-mcp cover basic operations. This server includes DeFi (Cetus, DeepBook), SuiNS, Move introspection, staking, validators, and full analytics.
  • GraphQL + JSON-RPC dual transport. Built on the official @mysten/sui v2.11 SDK with @mysten/suins for name service -- future-proofed for the GraphQL migration.
  • Tested end-to-end. 59 passing tests across devnet, testnet, and mainnet. Wallet creation, transfers, staking, DeFi queries, SuiNS resolution, and Move inspection all verified.

Token Shortcuts

Use symbol shortcuts instead of full coin type addresses:

ShortcutFull Coin Type
SUI0x2::sui::SUI
USDC0xdba34672e...::usdc::USDC
USDT0xc060006111...::coin::COIN
WETH0xaf8cd5edc1...::coin::COIN
DEEP0xdeeb7a4662...::deep::DEEP

Networks

Starts on devnet by default. Switch at any time with switch_network:

NetworkRPC Endpoint
mainnethttps://fullnode.mainnet.sui.io:443
testnethttps://fullnode.testnet.sui.io:443
devnethttps://fullnode.devnet.sui.io:443
localnethttp://127.0.0.1:9000

Security

  • Keys are in-memory only -- never written to disk, never logged
  • Private keys redacted from all error messages
  • Rate limiting: 120 calls/minute (sliding window)
  • All inputs validated with Zod strict schemas

Development

bash
git clone https://github.com/ExpertVagabond/sui-mcp-server.gitcd sui-mcp-servernpm installnpm run buildnpm start

License

MIT -- Matthew Karsten / Purple Squirrel Media

Source: README.md at commit 39d0d65

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.4.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts