sui-mcp
Provides tools for Sui blockchain analytics, including wallet overviews, DeFi positions, NFTs, token prices, transaction decoding, fund tracing, pool discovery, staking, Move bytecode decompilation, and Move Registry name resolution.
Click on "Install 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-mcpshow me my latest transactions"
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.
sui-mcp
Read-only MCP server for Sui blockchain analytics. 47 tools covering wallets, DeFi positions, NFTs, token prices, transaction decoding, incident investigation (labeled fund tracing, funding-source attribution, multi-address timelines, object provenance, PTB anomaly triage), pool discovery, staking, Move package analysis (disassembly + heuristic risk scan + capability audit + upgrade diffing, no external binary), optional Move bytecode decompilation, and Move Registry (MVR) name resolution.
No API keys, no wallet, no private keys — connects to public Sui endpoints (mainnet by default)
Per-call network — every tool takes an optional
networkarg (mainnet/testnet/devnet); query multiple networks in one session (e.g. compare a testnet value to mainnet).SUI_NETWORKsets only the default.Protocol-aware — decodes transactions from Cetus, Suilend, NAVI, Scallop, Bluefin, DeepBook, and more into human-readable actions
Multi-source architecture — gRPC for low-latency reads, GraphQL for filtered queries, archive node fallback for historical data
Price aggregation — Aftermath Finance, Pyth oracles, and CoinGecko in a single unified interface
Kiosk-aware — resolves NFT ownership through Sui's kiosk system to actual wallet addresses
Transaction building tools return unsigned bytes for external signing — the server never handles keys.
Setup
Requires Node.js >= 20 (22+ recommended).
npm install
npm run buildMove Decompiler (optional)
Reading and analyzing Move code works out of the box with no extra setup: disassemble_module returns Move bytecode assembly via the GraphQL endpoint, and analyze_package summarizes a package's API and runs a heuristic risk scan. The decompiler below is only needed if you want higher-level, source-like output.
The decompile_module tool requires the Revela move-decompiler binary. Requires a Rust toolchain (rustup.rs).
npm run build:decompilerThis clones verichains/revela_sui, builds the decompiler, and copies the binary to bin/move-decompiler.
git clone --depth 1 https://github.com/verichains/revela_sui.git
cd revela_sui/external-crates/move
cargo build --release --bin move-decompilerThen set SUI_DECOMPILER_PATH to the binary path.
Related MCP server: Sui MCP Server
Installation
Add to your MCP client config (Claude Code, Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"sui": {
"command": "node",
"args": ["/absolute/path/to/sui-mcp/dist/index.js"],
"env": {
"SUI_DECOMPILER_PATH": "/absolute/path/to/sui-mcp/bin/move-decompiler"
}
}
}
}Replace /absolute/path/to/sui-mcp with the actual path to this repository. The env block is only needed for the decompilation tool — omit it if you don't need decompile_module.
See .env.example for optional environment variables (network selection, custom RPC endpoints).
Tools (44)
Recommended Starting Points
Tool | Description |
| Identify what a Sui address is: wallet, package, validator, or object |
| Comprehensive wallet overview: balances, SuiNS name, staking, kiosks, recent txs |
| Decoded activity feed with protocol names and human-readable actions |
| Full token analysis: metadata, price, 24h change, supply, top holders |
Chain & Network
Tool | Description |
| Current chain ID, epoch, checkpoint height, timestamp, gas price |
| Checkpoint details by sequence number or digest |
Objects
Tool | Description |
| Object by ID with type, owner, JSON content, and display metadata |
| List objects owned by an address with optional type filter |
| Dynamic fields of an object (tables, kiosk contents, etc.) |
Coins & Tokens
Tool | Description |
| Balance of a coin type for an address (defaults to SUI) |
| Token metadata: name, symbol, decimals, description, supply |
| Search tokens by name/symbol, with Aftermath Finance fallback |
| USD prices for tokens — current (Aftermath + Pyth), or historical via Pyth when |
Transactions & Events
Tool | Description |
| Transaction by digest with protocol-decoded actions |
| Filter transactions by sender, address, object, or function |
| Filter events by type, sender, module, or checkpoint range |
DeFi
Tool | Description |
| DeFi positions across Suilend, Cetus, NAVI, Scallop, Bluefin, Bucket |
| Discover liquidity pools by token pair (Cetus, DeepBook, Turbos) |
| Pool reserves, fees, and prices for a given pool object ID |
NFTs
Tool | Description |
| List NFTs owned by a wallet, including kiosk-stored NFTs |
| Lightweight collection summary with counts |
| Top holders of an NFT collection or token |
Staking
Tool | Description |
| List validators (stake, commission, voting power), or full detail for one when |
| Wallet's staking positions and pools |
Names
Tool | Description |
| SuiNS name resolution (forward and reverse) |
Move Registry (MVR)
The Move Registry maps human-readable package names like @suins/core or @deepbook/core to on-chain package addresses. Backed by mainnet.mvr.mystenlabs.com/v1 (or testnet.mvr... when SUI_NETWORK=testnet).
Tool | Description |
| Resolve one or many MVR names → package IDs. Accepts version-pinned names like |
| Reverse-lookup: package addresses → MVR names. Useful for enriching raw addresses anywhere. |
| Full record for a name: metadata, version, package_address, package_info ID, git source. |
| Browse / search the registry. Supports substring search, pagination, and an |
| Resolve |
Typical flows:
"What's the package for
@deepbook/core?" →mvr_resolve(['@deepbook/core'])→0x4874e1.... Hand the address toget_packagefor module/function details."What is package
0xf22f…?" →mvr_reverse_resolve(['0xf22f…'])→@suins/core."Find DeepBook-related packages" →
mvr_search('deepbook', limit=20, is_linked=true)→ paginated list."Pin to a specific version" →
mvr_resolve(['@suins/core/3'])returns the v3 package address rather than the latest.
Packages (Developer)
Tool | Description |
| Move package modules, structs (with ordered fields), and functions |
| Specific Move function signature and parameters |
| Package dependency analysis with recursive traversal |
| Summarize a package's API + heuristic risk scan (no binary; accepts 0x id or MVR name) |
| Disassemble Move bytecode via GraphQL (no binary; accepts 0x id or MVR name) |
| Decompile Move bytecode to source (requires decompiler binary) |
| (Security) Diff two package versions to spot what an upgrade changed — malicious-upgrade / backdoor detection |
Transaction Building
Tool | Description |
| Build an unsigned transfer of SUI or any coin (auto coin selection); returns BCS for |
| Build an unsigned stake/unstake transaction ( |
| Dry-run a transaction to preview effects and gas cost |
Advanced
Tool | Description |
| Decode a Programmable Transaction Block from BCS bytes |
| Monitor address or object for new activity since a checkpoint |
Incident Investigation
Tool | Description |
| Swap-aware, USD-valued multi-hop fund tracing that stops at labeled sinks (forward or backward) |
| Walk an address back to its funding source(s) for attribution; stops at labeled exchanges/bridges |
| Merge multiple addresses' activity into one checkpoint-ordered, protocol-decoded timeline |
| Object provenance: version history + ownership transitions (who created/held an object when) |
| Address-label registry (exchanges, bridges, mixers, malicious wallets) used by the tracing tools |
| Diff two package versions to detect malicious upgrades / backdoors |
License
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityFmaintenanceAn MCP server for the Sui blockchain that enables AI agents to manage accounts, execute token swaps, and perform smart contract development using the Sui CLI. It supports over 30 tools for DeFi operations, staking, and market data via Pyth price oracles.Last updated232MIT
- AlicenseAqualityDmaintenanceAn MCP server providing tools for Sui blockchain interaction, including wallet management and Move smart contract development. It enables users to build, test, and publish contracts, query on-chain objects, and execute transactions through Claude.Last updated1415MIT
- AlicenseAqualityDmaintenanceMCP server with 43 tools for blockchain data — token lookups, wallet balances, live chain queries across 10+ networks, and full API documentation search.Last updated27305Apache 2.0
- AlicenseBqualityDmaintenanceComprehensive MCP server for the Sui blockchain with 53 tools covering wallets, DeFi (Cetus, DeepBook), SuiNS, staking, validators, Move introspection, and full RPC. Enables natural language interaction with the entire Sui ecosystem.Last updated53591MIT
Related MCP Connectors
Solana on-chain intelligence — token scans, wallet profiling, bundle detection, 19 MCP tools.
Solana MCP for wallets, trades, markets, PnL, transfers, onchain data, signable swaps and API tools.
Crypto intelligence MCP for market data, DeFi, wallets, security, DEX, NFTs, and Solana.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/0xfreak0/sui-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server