Provides comprehensive tools for interacting with the Sui blockchain, including wallet management, transfers, staking, DeFi (Cetus, DeepBook), SuiNS name service, Move smart contract introspection, and network analytics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@sui-mcp-server check SUI balance for 0xabc123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
npx sui-mcp-serverOr install globally:
npm install -g sui-mcp-server
sui-mcp-serverRelated MCP server: Stacks AI MCP Server
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.
Tool | Description | Key Params |
| Create a new Ed25519 keypair (in-memory only, not persisted) | -- |
| Import from a Bech32-encoded private key ( |
|
| List all wallets in the current session | -- |
| Get SUI balance for any address |
|
Tool | Description | Key Params |
| All coin balances for an address (SUI + other coin types) |
|
| Coin objects of a specific type owned by an address |
|
| Metadata for a coin type (name, symbol, decimals) |
|
| Total circulating supply of a coin type |
|
Tool | Description | Key Params |
| Transfer SUI between addresses (amount in SUI, not MIST) |
|
| Transfer one or more objects to a recipient |
|
| Merge multiple coins into one (handles gas conflicts) |
|
| Split a coin into multiple coins |
|
Tool | Description | Key Params |
| Full details of any on-chain object by ID |
|
| Objects owned by an address with optional type filtering |
|
| Dynamic fields of an object (tables, bags) |
|
| Batch-fetch up to 50 objects in one call |
|
| Trace all transactions that touched a given object |
|
Tool | Description | Key Params |
| Full transaction details by digest |
|
| Dry-run to preview effects without executing |
|
| Search by sender, recipient, object, or Move function |
|
| Total transaction count on the network | -- |
Tool | Description | Key Params |
| Execute a Move function call |
|
| Simulate a Move call without executing (no wallet needed) |
|
| Full Move module definition (functions, structs) |
|
| Move function details (params, return types, visibility) |
|
| Move struct definition (fields, abilities) |
|
| List all modules in a Move package |
|
| Network-wide Move call metrics | -- |
Tool | Description | Key Params |
| All staking positions for an address |
|
| Stake SUI with a validator |
|
| Withdraw staked SUI |
|
| Full validator set with APY, commission, and stake amounts | -- |
Tool | Description | Key Params |
| Query on-chain events by type, sender, package, or digest |
|
Tool | Description | Key Params |
| Switch between mainnet, testnet, devnet, localnet |
|
| Chain ID, epoch, gas price, latest checkpoint | -- |
| Latest checkpoint sequence number | -- |
| Current reference gas price in MIST | -- |
| Detailed checkpoint data by sequence number |
|
| Historical epoch data (times, stakes, gas summaries) |
|
| Sui protocol configuration (limits, features) | -- |
| Full system state: epoch, validators, storage fund | -- |
| Validator committee info for any epoch |
|
Tool | Description | Key Params |
| Resolve |
|
| Reverse-resolve an address to SuiNS name(s) |
|
| Full name record -- NFT ID, target, expiration, metadata |
|
| Registration and renewal pricing by name length |
|
Tool | Description | Key Params |
| Query Cetus CLMM pools by coin types |
|
| Detailed pool data for a specific Cetus pool |
|
Tool | Description | Key Params |
| DeepBook v3 order book data -- pool state and dynamic fields |
|
Tool | Description | Key Params |
| Token price by querying DeFi pool reserves |
|
| Swap quote by simulating against a pool |
|
| Common Sui tokens with full coin type addresses | -- |
Tool | Description | Key Params |
| Request SUI from faucet (devnet and testnet only) |
|
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.
Use symbol shortcuts instead of full coin type addresses:
Shortcut | Full Coin Type |
|
|
|
|
|
|
|
|
|
|
Starts on devnet by default. Switch at any time with switch_network:
Network | RPC Endpoint |
|
|
|
|
|
|
|
|
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
git clone https://github.com/ExpertVagabond/sui-mcp-server.git
cd sui-mcp-server
npm install
npm run build
npm startMIT -- Matthew Karsten / Purple Squirrel Media
Get detailed info for a specific Cetus pool by its object ID.
Inputs: poolId (required).
Query Cetus CLMM pools by coin types. Returns pool addresses, liquidity, and fee rates.
Inputs: coinTypeA, coinTypeB, limit.
Create a new Sui wallet (Ed25519 keypair). Keys are held in memory only.
Inputs: name (required).
Get DeepBook v3 pool info (order book) — mid price, spread, balances.
Inputs: poolId (required).
Simulate a Move call without executing it — returns results, gas cost, and effects. No wallet needed.
Inputs: sender (required), target (required), arguments, typeArguments.
Dry-run a transaction to preview effects without executing.
Inputs: txBytes (required).
Get all coin balances for an address (SUI and all other coin types).
Inputs: address (required).
Get SUI balance for an address.
Inputs: address (required).
Get detailed checkpoint data by sequence number.
Inputs: sequenceNumber (required).
Get metadata for a coin type (name, symbol, decimals, description).
Inputs: coinType (required).
Get coin objects of a specific type owned by an address.
Inputs: address (required), coinType, limit.
Get validator committee information for a specific epoch.
Inputs: epoch.
Get dynamic fields of an object.
Inputs: parentId (required), limit.
Get detailed info about epochs (current or historical).
Inputs: limit, order.
Get the latest checkpoint sequence number.
Inputs: no named parameters.
Get Move call metrics — most-called packages, modules, and functions.
Inputs: no named parameters.
Get details of a specific Move function.
Inputs: packageId (required), moduleName (required), functionName (required).
Get a Move struct definition (fields, abilities, type parameters).
Inputs: packageId (required), moduleName (required), structName (required).
Get current network info: chain ID, epoch, reference gas price, checkpoint.
Inputs: no named parameters.
Get the normalized Move module definition (functions, structs, etc.).
Inputs: packageId (required), moduleName (required).
Get details of a Sui object by its ID.
Inputs: objectId (required), showContent, showType, showOwner.
Find all transactions that touched a given object (trace provenance).
Inputs: objectId (required), limit.
Get objects owned by an address.
Inputs: address (required), limit, filter.
List all modules in a Move package, with their functions and structs.
Inputs: packageId (required).
Get the current Sui protocol configuration (limits, features, gas settings).
Inputs: no named parameters.
Get current reference gas price.
Inputs: no named parameters.
Get all staking positions for an address.
Inputs: address (required).
Get the full Sui system state: epoch, validators, stake distribution, gas price, storage fund.
Inputs: no named parameters.
Get approximate token price by querying DeFi pool reserves. Supports common tokens: SUI, USDC, USDT, WETH, DEEP.
Inputs: token (required).
Get total supply of a coin type.
Inputs: coinType (required).
Get the total number of transactions on the network.
Inputs: no named parameters.
Get transaction details by digest.
Inputs: digest (required), showInput, showEffects, showEvents.
Get current validator set with APY, commission, and stake info.
Inputs: no named parameters.
Import a Sui wallet from a Bech32-encoded private key (suiprivkey...).
Inputs: name (required), privateKey (required).
List commonly used Sui token types (SUI, USDC, USDT, WETH, DEEP) with their full coin type addresses.
Inputs: no named parameters.
List all wallets managed in this session.
Inputs: no named parameters.
Merge multiple coins into one. All coins must be the same type.
Inputs: wallet (required), primaryCoin (required), coinsToMerge (required).
Execute a Move function call. Arguments are passed as an array of strings/numbers.
Inputs: wallet (required), target (required), arguments, typeArguments.
Batch-fetch multiple objects by their IDs in one call.
Inputs: objectIds (required), showContent, showType.
Query on-chain events by type, sender, package, module, or transaction digest.
Inputs: filter (required), limit, order.
Search and filter transactions by sender, recipient, input object, changed object, or Move function.
Inputs: filter (required), limit, order.
Stake SUI with a validator. Amount is in SUI.
Inputs: wallet (required), validatorAddress (required), amount (required).
Request SUI from the faucet (devnet/testnet only).
Inputs: address (required).
Withdraw staked SUI.
Inputs: wallet (required), stakeObjectId (required).
Reverse-resolve an address to its SuiNS name(s).
Inputs: address (required).
Resolve a SuiNS name to an address.
Inputs: name (required).
Split a coin into multiple coins with specified amounts (in MIST).
Inputs: wallet (required), coinId (required), amounts (required).
Get detailed SuiNS name record — NFT ID, target address, expiration, metadata.
Inputs: name (required).
Get SuiNS registration and renewal pricing.
Inputs: name (required), years.
Get a swap quote by simulating a Move call. Returns estimated output amount and gas cost without executing.
Inputs: fromCoin (required), toCoin (required), amount (required), poolId (required).
Switch to a different Sui network.
Inputs: network (required).
Transfer one or more objects to a recipient address.
Inputs: fromWallet (required), toAddress (required), objectIds (required).
Transfer SUI from a managed wallet to a recipient address. Amount is in SUI (not MIST).
Inputs: fromWallet (required), toAddress (required), amount (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 53 tools
Tools are generally well-distinguished with specific purposes, though the large number of get_* query tools (e.g., get_epoch_info, get_checkpoint, get_system_state) could cause minor confusion if descriptions are not carefully read. Overall, the overlap is minimal.
All tools follow snake_case and a consistent verb_noun pattern. Prefixes like cetus_, deepbook_, suins_ are used sparingly and logically. No mixing of naming conventions.
With 53 tools, the surface is far too large for an MCP server. Agents will face a overwhelming number of options, many of which could be combined or omitted. This exceeds even the 25+ threshold for 'too many'.
The tool set covers virtually all major Sui blockchain operations: wallet management, token operations, DeFi interactions, staking, naming services, network queries, transaction history, and Move execution. No obvious gaps are present.
OpenAI-compatible LLM MCP (7 tools); chat via balance key or x402 USDC on Base
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
