Sui Analytics
Read-only Sui investigation tools: fund tracing, transaction decoding and wallet forensics
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.29.0
- Listing updated
- today
Similar MCP servers
About Sui Analytics
Sui Analytics is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.
Sui Analytics is built for investigating what happened on chain without being able to change anything: no wallet, no keys and it never submits a transaction. It traces funds along a selected path and lists the branches it did not follow, follows coin and object handovers in a flow graph with explicit bounds, and decodes transactions with swap directions taken from pool events when possible.
The README walks through the May 2025 Cetus exploit, where get_transaction_history finds the attacker's first success and analyze_attack_tx reports the gain, the pool price move and anomaly flags. Other tools scan objects by Move type, search pools by venue, report LP custody and decompile Move modules when a local Revela binary is set. Prompts cover everyday questions such as who controls a token or protocol.
It reads public Sui endpoints on mainnet by default, needs no account or API key and requires Node.js 22.13 or newer. USD values are provider-based estimates, and chain text is marked untrusted_text so it is treated as data.
Install
Run in a terminal
claude mcp add sui-mcp -- npx -y sui-analytics-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"sui-mcp": {
"command": "npx",
"args": [
"-y",
"sui-analytics-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sui-mcp": {
"command": "npx",
"args": [
"-y",
"sui-analytics-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sui-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sui-analytics-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sui-mcp": {
"command": "npx",
"args": [
"-y",
"sui-analytics-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sui-mcp": {
"command": "npx",
"args": [
"-y",
"sui-analytics-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SUI_NETWORKDefault network when a tool call doesn't pass one. Every tool also takes a per-call network argument.SUI_FULLNODE_URLOverride the gRPC fullnode endpoint for the default network only.SUI_GRAPHQL_URLOverride the GraphQL endpoint for the default network only.SUI_RATE_LIMITRequests per 10 seconds sent to one RPC endpoint. Defaults to 180 for *.sui.io endpoints and no limit for others; 0 turns it off.SUI_TOOLSTool profiles to load at startup, comma-separated, or 'all'. Defaults to 'core'.SUI_DECOMPILER_PATHPath to a locally built Revela move-decompiler binary. Only decompile_module needs it.SUI_LABELS_FILEJSON file of address attribution labels that overrides the shipped set for fund tracing.
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- get_transaction
- Decodes a transaction and attributes swap directions to pool events.
- get_transaction_history
- Lists an address's transactions in order.
- analyze_attack_tx
- Analyses an exploit transaction for gains, price impact and anomalies.
- trace_funds
- Follows fund movements along a selected path.
- trace_flow_graph
- Follows coin and valued-object handovers.
- list_objects_by_type
- Scans current objects by Move struct or module.
- find_pools
- Finds liquidity pools and reports coverage by venue.
- analyze_token
- Analyses a token including current LP custody.
- decompile_module
- Decompiles a Move module using a local Revela binary.
What it does
- Fund tracing
- trace_funds follows a path and reports unfollowed branches; trace_flow_graph follows coin and object handovers.
- Transaction decoding
- get_transaction attributes swap directions to pool events where it can.
- Attack analysis
- analyze_attack_tx summarises gains, pool price impact and anomalies.
- Object scans
- list_objects_by_type counts and sums fields across owners, reporting incomplete rows.
- Pool and token checks
- find_pools and analyze_token report coverage and LP custody.
- Tool profiles
- SUI_TOOLS loads the core set or adds forensics tools.
Good for
- Trace where stolen funds went after an exploit
- Work out who can mint, freeze or upgrade a token
- Identify what kind of account a wallet is and how it was funded
- Inspect a protocol's admin caps and upgrade rights
- Decompile a Move module to review it
Pricing
Open source
MIT licence; no key needed
Sui Analytics FAQ
Can it move funds?
No. It is read-only with no wallet or keys and never submits transactions.
Does it need an API key?
No account, key or config file is required; it reads public Sui endpoints.
Which networks?
Mainnet by default, with testnet and devnet selectable through SUI_NETWORK or a per-call argument.
How accurate are USD totals?
They are provider-based estimates, according to the README.
Is Sui Analytics free?
Yes. Sui Analytics is open source, so you can use and self-host it for free.
How do I add Sui Analytics to Claude Code?
Run this command in your terminal: claude mcp add sui-mcp -- npx -y sui-analytics-mcp
What are the best alternatives to Sui Analytics?
The closest alternatives to Sui Analytics are REA, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons and AiSOC.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


