io.github.ExpertVagabond/sui-mcp-server

NPM · SUI-MCP-SERVER · SCANNED AUG 3

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

Available components

+25 this week 71 71 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security88

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (132 of 133), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (132 of 133), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 129 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability81

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 2564 tokens (~48/item across 53 items; 53 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · sui-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add expertvagabond-sui-mcp-server -- npx -y sui-mcp-server

# add to Codex CLI

codex mcp add expertvagabond-sui-mcp-server -- npx -y sui-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "expertvagabond-sui-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "sui-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add expertvagabond-sui-mcp-server --command npx --arg -y --arg sui-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  expertvagabond-sui-mcp-server:
    command: "npx"
    args: ["-y", "sui-mcp-server"]

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +65
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 −23
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 132 packages

132 packages in the resolved dependency tree · 131 deprecated · 35 stale · 1 without a linked repository.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 53 exposed · ~2,564 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

cetus_get_pool ~37

Get detailed info for a specific Cetus pool by its object ID.

Input Output Examples

Name	Type	Req	Description
poolId	string	yes	Cetus pool object ID

No output schema declared.

No examples provided.

cetus_get_pools ~107

Query Cetus CLMM pools by coin types. Returns pool addresses, liquidity, and fee rates.

Input Output Examples

Name	Type	Req	Description
coinTypeA	string	—	Coin type A (e.g. 0x2::sui::SUI). Use 'SUI', 'USDC', 'USDT', 'WETH', 'DEEP' as shortcuts.
coinTypeB	string	—	Coin type B
limit	number	—	Max pools (default: 10)

No output schema declared.

No examples provided.

create_wallet ~46

Create a new Sui wallet (Ed25519 keypair). Keys are held in memory only.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Wallet name (alphanumeric, hyphens, underscores)

No output schema declared.

No examples provided.

deepbook_get_pool ~42

Get DeepBook v3 pool info (order book) — mid price, spread, balances.

Input Output Examples

Name	Type	Req	Description
poolId	string	yes	DeepBook pool object ID

No output schema declared.

No examples provided.

dev_inspect ~78

Simulate a Move call without executing it — returns results, gas cost, and effects. No wallet needed.

Input Output Examples

Name	Type	Req	Description
arguments	array	—	Function arguments
sender	string	yes	Sender address to simulate from
target	string	yes	Move call target: package::module::function
typeArguments	array	—	Type arguments

No output schema declared.

No examples provided.

dry_run_transaction ~33

Dry-run a transaction to preview effects without executing.

Input Output Examples

Name	Type	Req	Description
txBytes	string	yes	Base64-encoded transaction bytes

No output schema declared.

No examples provided.

get_all_balances ~36

Get all coin balances for an address (SUI and all other coin types).

Input Output Examples

Name	Type	Req	Description
address	string	yes	Sui address

No output schema declared.

No examples provided.

get_balance ~29

Get SUI balance for an address.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Sui address (0x...)

No output schema declared.

No examples provided.

get_checkpoint ~28

Get detailed checkpoint data by sequence number.

Input Output Examples

Name	Type	Req	Description
sequenceNumber	string	yes	Checkpoint sequence number

No output schema declared.

No examples provided.

get_coin_metadata ~48

Get metadata for a coin type (name, symbol, decimals, description).

Input Output Examples

Name	Type	Req	Description
coinType	string	yes	Coin type (e.g. 0x2::sui::SUI)

No output schema declared.

No examples provided.

get_coins ~69

Get coin objects of a specific type owned by an address.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Owner address
coinType	string	—	Coin type (default: 0x2::sui::SUI)
limit	number	—	Max coins to return (default: 50)

No output schema declared.

No examples provided.

get_committee_info ~32

Get validator committee information for a specific epoch.

Input Output Examples

Name	Type	Req	Description
epoch	string	—	Epoch number (default: current)

No output schema declared.

No examples provided.

get_dynamic_fields ~43

Get dynamic fields of an object.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Max fields to return (default: 50)
parentId	string	yes	Parent object ID

No output schema declared.

No examples provided.

get_epoch_info ~49

Get detailed info about epochs (current or historical).

Input Output Examples

Name	Type	Req	Description
limit	number	—	Number of epochs to return (default: 5)
order	string	—	Sort order (default: descending)

No output schema declared.

No examples provided.

get_latest_checkpoint ~16

Get the latest checkpoint sequence number.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_move_call_metrics ~24

Get Move call metrics — most-called packages, modules, and functions.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_move_function ~48

Get details of a specific Move function.

Input Output Examples

Name	Type	Req	Description
functionName	string	yes	Function name
moduleName	string	yes	Module name
packageId	string	yes	Package object ID

No output schema declared.

No examples provided.

get_move_struct ~53

Get a Move struct definition (fields, abilities, type parameters).

Input Output Examples

Name	Type	Req	Description
moduleName	string	yes	Module name
packageId	string	yes	Package object ID
structName	string	yes	Struct name

No output schema declared.

No examples provided.

get_network_info ~25

Get current network info: chain ID, epoch, reference gas price, checkpoint.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_normalized_module ~44

Get the normalized Move module definition (functions, structs, etc.).

Input Output Examples

Name	Type	Req	Description
moduleName	string	yes	Module name
packageId	string	yes	Package object ID

No output schema declared.

No examples provided.

get_object ~74

Get details of a Sui object by its ID.

Input Output Examples

Name	Type	Req	Description
objectId	string	yes	Object ID
showContent	boolean	—	Include object content (default: true)
showOwner	boolean	—	Include owner info (default: true)
showType	boolean	—	Include object type (default: true)

No output schema declared.

No examples provided.

get_object_history ~47

Find all transactions that touched a given object (trace provenance).

Input Output Examples

Name	Type	Req	Description
limit	number	—	Max transactions (default: 20)
objectId	string	yes	Object ID to trace

No output schema declared.

No examples provided.

get_owned_objects ~74

Get objects owned by an address.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Owner address
filter	object	—	Optional filter: { StructType: '0x2::coin::Coin<0x2::sui::SUI>' }
limit	number	—	Max objects to return (default: 50)

No output schema declared.

No examples provided.

get_package_modules ~34

List all modules in a Move package, with their functions and structs.

Input Output Examples

Name	Type	Req	Description
packageId	string	yes	Package object ID

No output schema declared.

No examples provided.

get_protocol_config ~24

Get the current Sui protocol configuration (limits, features, gas settings).

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_reference_gas_price ~17

Get current reference gas price.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_stakes ~27

Get all staking positions for an address.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Staker address

No output schema declared.

No examples provided.

get_system_state ~30

Get the full Sui system state: epoch, validators, stake distribution, gas price, storage fund.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_token_price ~68

Get approximate token price by querying DeFi pool reserves. Supports common tokens: SUI, USDC, USDT, WETH, DEEP.

Input Output Examples

Name	Type	Req	Description
token	string	yes	Token symbol (SUI, USDC, USDT, WETH, DEEP) or full coin type

No output schema declared.

No examples provided.

get_total_supply ~27

Get total supply of a coin type.

Input Output Examples

Name	Type	Req	Description
coinType	string	yes	Coin type

No output schema declared.

No examples provided.

get_total_transactions ~19

Get the total number of transactions on the network.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_transaction ~66

Get transaction details by digest.

Input Output Examples

Name	Type	Req	Description
digest	string	yes	Transaction digest
showEffects	boolean	—	Show effects (default: true)
showEvents	boolean	—	Show events (default: true)
showInput	boolean	—	Show transaction input (default: true)

No output schema declared.

No examples provided.

get_validators ~23

Get current validator set with APY, commission, and stake info.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

import_wallet ~56

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

Input Output Examples

Name	Type	Req	Description
name	string	yes	Wallet name
privateKey	string	yes	Bech32 private key (suiprivkey...)

No output schema declared.

No examples provided.

list_common_tokens ~39

List commonly used Sui token types (SUI, USDC, USDT, WETH, DEEP) with their full coin type addresses.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_wallets ~17

List all wallets managed in this session.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

merge_coins ~63

Merge multiple coins into one. All coins must be the same type.

Input Output Examples

Name	Type	Req	Description
coinsToMerge	array	yes	Object IDs of coins to merge
primaryCoin	string	yes	Object ID of the coin to merge into
wallet	string	yes	Wallet name

No output schema declared.

No examples provided.

move_call ~74

Execute a Move function call. Arguments are passed as an array of strings/numbers.

Input Output Examples

Name	Type	Req	Description
arguments	array	—	Function arguments
target	string	yes	Move call target: package::module::function
typeArguments	array	—	Type arguments for generic functions
wallet	string	yes	Wallet name for signing

No output schema declared.

No examples provided.

multi_get_objects ~62

Batch-fetch multiple objects by their IDs in one call.

Input Output Examples

Name	Type	Req	Description
objectIds	array	yes	Array of object IDs to fetch
showContent	boolean	—	Include content (default: true)
showType	boolean	—	Include type (default: true)

No output schema declared.

No examples provided.

query_events ~107

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

Input Output Examples

Name	Type	Req	Description
filter	object	yes	Event filter. Examples: { "MoveEventType": "0x2::coin::CoinEvent" }, { "Sender": "0x..." }, { "Package": "0x2" }, { "Transaction": "digest..." }
limit	number	—	Max events (default: 50)
order	string	—	Sort order (default: descending)

No output schema declared.

No examples provided.

query_transactions ~133

Search and filter transactions by sender, recipient, input object, changed object, or Move function.

Input Output Examples

Name	Type	Req	Description
filter	object	yes	Transaction filter. Examples: { "FromAddress": "0x..." }, { "ToAddress": "0x..." }, { "InputObject": "0x..." }, { "ChangedObject": "0x..." }, { "MoveFunction": { "package": "0x2", "module": "coin", "…
limit	number	—	Max transactions (default: 50)
order	string	—	Sort order (default: descending)

No output schema declared.

No examples provided.

request_add_stake ~55

Stake SUI with a validator. Amount is in SUI.

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Amount of SUI to stake
validatorAddress	string	yes	Validator address
wallet	string	yes	Wallet name

No output schema declared.

No examples provided.

request_faucet ~33

Request SUI from the faucet (devnet/testnet only).

Input Output Examples

Name	Type	Req	Description
address	string	yes	Address to fund

No output schema declared.

No examples provided.

request_withdraw_stake ~41

Withdraw staked SUI.

Input Output Examples

Name	Type	Req	Description
stakeObjectId	string	yes	StakedSui object ID
wallet	string	yes	Wallet name

No output schema declared.

No examples provided.

resolve_address ~31

Reverse-resolve an address to its SuiNS name(s).

Input Output Examples

Name	Type	Req	Description
address	string	yes	Sui address

No output schema declared.

No examples provided.

resolve_name ~36

Resolve a SuiNS name to an address.

Input Output Examples

Name	Type	Req	Description
name	string	yes	SuiNS name (e.g. example.sui)

No output schema declared.

No examples provided.

split_coins ~64

Split a coin into multiple coins with specified amounts (in MIST).

Input Output Examples

Name	Type	Req	Description
amounts	array	yes	Amounts for each new coin (in MIST)
coinId	string	yes	Object ID of the coin to split
wallet	string	yes	Wallet name

No output schema declared.

No examples provided.

suins_get_name_record ~47

Get detailed SuiNS name record — NFT ID, target address, expiration, metadata.

Input Output Examples

Name	Type	Req	Description
name	string	yes	SuiNS name (e.g. example.sui)

No output schema declared.

No examples provided.

suins_get_price ~47

Get SuiNS registration and renewal pricing.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Domain name to check price for
years	number	—	Number of years (default: 1)

No output schema declared.

No examples provided.

swap_quote ~97

Get a swap quote by simulating a Move call. Returns estimated output amount and gas cost without executing.

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Amount to swap (in token units, not MIST)
fromCoin	string	yes	Source coin type or shorthand (SUI, USDC, etc.)
poolId	string	yes	Pool object ID to use for the swap
toCoin	string	yes	Destination coin type or shorthand

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug