# Sui Analytics

> Sui Analytics is an open-source MCP server for analytics and data. Read-only Sui investigation tools: fund tracing, transaction decoding and wallet forensics. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/0xfreak0/sui-mcp
- **MCP Registry name:** io.github.0xfreak0/sui-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [finance and payments](https://ai-powered.com/categories/finance-and-payments), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add sui-mcp -- npx -y sui-analytics-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sui-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/sui-analytics
