Skip to content
MCP server

Sui Analytics

Read-only Sui investigation tools: fund tracing, transaction decoding and wallet forensics

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers