# Sui Analytics (npm · sui-analytics-mcp)

Read-only Sui blockchain analytics: 59 tools, protocol-aware tx decoding, no API keys or wallet.

- Trust score: 83/100 (high trust)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-12

## Components

- npm · `sui-analytics-mcp`: 83/100 (this document), [markdown](https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp.md), [page](https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp)

## Channel facts

- Registry: `npm`
- Package: `sui-analytics-mcp`
- Version: `1.6.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-12.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 42 of 152 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to 0xfreak0/sui-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 82/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3592 tokens (~189/item across 19 items; 18 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add 0xfreak0-sui-mcp -- npx -y sui-analytics-mcp
```

### Codex

```bash
codex mcp add 0xfreak0-sui-mcp -- npx -y sui-analytics-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "0xfreak0-sui-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "sui-analytics-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add 0xfreak0-sui-mcp --command npx --arg -y --arg sui-analytics-mcp
```

### Hermes

```yaml
mcp_servers:
  0xfreak0-sui-mcp:
    command: "npx"
    args: ["-y", "sui-analytics-mcp"]
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-12 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-11 (score 82, +12)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-08-10 (score 70, −10)

- [security regression] Known CVEs: pass → unverified
- [functional regression] Dependency health: 0.88 → unverified
- [functional improvement] Stability: unverified → 0.07
- [functional] Package version: 1.5.0 → 1.6.0

### 2026-08-08 (score 80, +41)

- [security improvement] Known CVEs: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Dependency health: unverified → 0.88
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] Package version: 1.4.1 → 1.5.0

### 2026-08-07 (score 39)

First indexed and scored.

## MCP tools (18)

### `get_chain_info` (~126 tokens)

Get current Sui network info: chain ID, epoch, checkpoint height, timestamp, and reference gas price. Optionally pass an epoch number to get details for a specific epoch.

Input parameters:

- `epoch` (string): Epoch number to query. Returns current epoch info if omitted.
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_object` (~134 tokens)

Get a Sui object by its ID. Returns type, owner, version, content (JSON), and digest. Automatically extracts display metadata (name, description, image_url) for NFTs.

Input parameters:

- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `object_id` (string, required): The object ID (0x...)
- `version` (string): Specific version to fetch

### `list_owned_objects` (~193 tokens)

List raw objects owned by a Sui address with optional type filter and pagination. For NFTs specifically, prefer list_nfts (resolves kiosk storage, extracts display metadata). For a wallet summary, prefer get_wallet_overview.

Input parameters:

- `cursor` (string): Pagination cursor from previous response
- `limit` (number): Max results (default 50, max 1000)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `object_type` (string): Filter by object type (e.g. 0x2::coin::Coin<0x2::sui::SUI>)
- `owner` (string, required): Owner address (0x...)

### `get_balance` (~152 tokens)

Get the balance of a specific coin type for a Sui address. Defaults to SUI. Optionally query balance at a historical checkpoint.

Input parameters:

- `at_checkpoint` (number): Query balance at a specific checkpoint (for historical balances)
- `coin_type` (string): Coin type (default: 0x2::sui::SUI)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `owner` (string, required): Owner address (0x...)

### `get_transaction` (~126 tokens)

Get a Sui transaction by its digest. Returns sender, status, gas, events, balance changes, and protocol-aware decoded actions (e.g. 'swap on Cetus', 'deposit on Suilend').

Input parameters:

- `digest` (string, required): Transaction digest (Base58)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `query_transactions` (~415 tokens)

Query raw Sui transactions with specific filters (sender, affected address/object, function, checkpoint range). Note: only ONE of affected_address, affected_object, or function can be used per query (Sui GraphQL limitation). For human-readable wallet activity, prefer get_transaction_history instead.

ATTRIBUTION WARNING: the `function` filter matches any transaction containing that call, including PTBs where it is one leg among several protocols. A transaction's balance changes cover the WHOLE PTB, so summing them per protocol over-attributes — a big Cetus swap in the same PTB will be counted as your protocol's volume. Set include_functions to see every Move call in each transaction, and prefer the protocol's own events (query_events) when measuring per-protocol flow.

Input parameters:

- `affected_address` (string): Filter by affected address (sender, sponsor, or recipient). Mutually exclusive with affected_object and function.
- `affected_object` (string): Filter by affected object ID. Mutually exclusive with affected_address and function.
- `after` (string): Pagination cursor
- `after_checkpoint` (string): Only transactions after this checkpoint
- `before_checkpoint` (string): Only transactions before this checkpoint
- `function` (string): Filter by Move function (e.g. 0x2::coin::transfer or 0x2::pay). Mutually exclusive with affected_address and affected_object.
- `include_functions` (boolean): Return every Move call in each transaction, so you can see whether the filtered package was the whole transaction or one leg of a multi-protocol PTB.
- `limit` (number): Max results (default 20)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `sender` (string): Filter by sender address

### `resolve_name` (~153 tokens)

Resolve a SuiNS name (.sui domain) to an address, or reverse-lookup an address to its SuiNS name. At least one of 'name' or 'address' must be provided.

Input parameters:

- `address` (string): Address to reverse-lookup to a SuiNS name
- `name` (string): SuiNS name to resolve (e.g. 'example.sui')
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_wallet_overview` (~164 tokens)

(Recommended first tool for wallets) Get a comprehensive overview of a Sui wallet: all token balances, SuiNS name, staked SUI count, kiosk/NFT count, and recent transactions. Set include_prices=true for USD values and total portfolio value. Start here before drilling into specific tools.

Input parameters:

- `address` (string, required): Wallet address (0x...)
- `include_prices` (boolean): Include USD prices and portfolio value (default: false)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_token_prices` (~263 tokens)

Get USD prices for Sui tokens — current by default, or historical when `at` is set. Current prices use Aftermath (primary) + Pyth (fallback); historical prices use the Pyth oracle at the given time. Accepts full coin type strings (e.g. 0x2::sui::SUI).

Input parameters:

- `at` (number|string): Optional: price AT this point in time — Unix seconds or ISO 8601 (e.g. '2025-01-15T00:00:00Z'). Omit for current prices.
- `coin_types` (array, required): Array of full coin type strings (e.g. ['0x2::sui::SUI', '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC'])
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_defi_positions` (~148 tokens)

Find DeFi positions owned by a Sui wallet across major protocols: Suilend, Cetus LP, NAVI, Scallop, Bluefin, Bucket, and staked SUI. Returns extracted position summaries (deposits, borrows, liquidity, fees) instead of raw on-chain data.

Input parameters:

- `address` (string, required): Wallet address (0x...)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `list_nfts` (~264 tokens)

(Recommended for NFTs) List NFTs owned by a wallet, including kiosk-stored NFTs. Returns display metadata (name, description, image URL) and raw Move struct contents inline. Backed by GraphQL — single query per kiosk page, no fullnode rate-limit risk. Pagination: pass `cursor` from a prior response to fetch the next page; the response omits `next_cursor` when the wallet is fully enumerated. May slightly overshoot `limit` because GraphQL pages are 50-at-a-time and we don't break mid-page. Use list_nft_collections for a cheaper count-only summary.

Input parameters:

- `address` (string, required): Owner wallet address (0x...)
- `cursor` (string): Opaque pagination token from a prior response's `next_cursor`. Omit on first call.
- `limit` (number): Target page size (default 50, max 1000). Result may slightly exceed this at GraphQL page boundaries.
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `list_nft_collections` (~124 tokens)

Get a lightweight summary of NFT collections owned by a wallet. Walks all kiosks plus direct-owned objects and returns deduplicated collection types with counts. Backed by GraphQL.

Input parameters:

- `address` (string, required): Owner wallet address (0x...)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_staking_summary` (~112 tokens)

Get a wallet's staking positions on Sui. Shows all StakedSui objects with pool, principal amount, and activation epoch.

Input parameters:

- `address` (string, required): Wallet address (0x...)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `get_transaction_history` (~186 tokens)

(Recommended for wallet activity) Get decoded transaction history for a Sui wallet. Returns a human-readable activity feed with protocol names (e.g. Cetus, Suilend), action descriptions (e.g. 'Swap USDC → SUI'), and token flow. Prefer this over query_transactions when exploring what a wallet has been doing.

Input parameters:

- `address` (string, required): Sui wallet address (0x...)
- `after` (string): Pagination cursor for next page
- `limit` (number): Number of transactions to return (default 10, max 50)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `find_pools` (~188 tokens)

Find DeFi liquidity pools by token pair. Searches Cetus, DeepBook, and Turbos for pools matching the given tokens. Use get_pool_stats on a returned pool_id for detailed stats.

Input parameters:

- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `protocol` (string): Filter by protocol: 'cetus', 'deepbook', or 'turbos'. Searches all if omitted.
- `token_a` (string, required): First token: symbol (e.g. 'SUI') or full coin type
- `token_b` (string, required): Second token: symbol (e.g. 'USDC') or full coin type

### `identify_address` (~148 tokens)

(Recommended first step) Identify what a Sui address is: wallet, package, validator, or object. Returns a type classification with contextual summary (e.g. balance + SuiNS for wallets, module list for packages, stake info for validators). Use this before deciding which other tools to call.

Input parameters:

- `address` (string, required): Sui address or object ID (0x...)
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…

### `analyze_token` (~211 tokens)

(Recommended for token research) Get a comprehensive analysis of a Sui token in one call: metadata, current price, 24h change, total supply, and top 5 holders. Accepts either a coin type (e.g. '0x2::sui::SUI') or a name/symbol (e.g. 'DEEP', 'cetus').

Input parameters:

- `include_holders` (boolean): Include top 5 holders (default: true). Set false for faster response.
- `network` (string): Which Sui network to run this call against: 'mainnet' (default), 'testnet', or 'devnet'. Set this per-call — different tool calls in the same session can target different networks (e.g. to compare a…
- `query` (string, required): Token name, symbol (e.g. 'USDC', 'deep'), or full coin type (e.g. '0x2::sui::SUI')

### `enable_tools` (~467 tokens)

Turn on additional Sui tool profiles for this session. This server ships a small default tool surface and keeps the rest one call away. Call this FIRST whenever the capability you need is not in your current tool list — the tool probably exists and is simply disabled. Do not reimplement a listed tool by hand.

'core' — Everyday lookups — wallets, balances, transactions, tokens, NFTs, DeFi positions. Tools: identify_address, get_wallet_overview, get_transaction, get_transaction_history, query_transactions, get_object, list_owned_objects, get_balance, analyze_token, get_token_prices, list_nfts, list_nft_collections, get_defi_positions, get_staking_summary, find_pools, resolve_name, get_chain_info
'forensics' — Incident investigation — fund tracing, batch funding attribution, address fan-out, multi-address timelines, object provenance, address labels, oracle-vs-market deviation, and recording findings into an exportable case report. Tools: resolve_protocol_packages, sample_control_addresses, trace_funds, find_funding_source, find_funding_sources, get_address_fanout, build_timeline, trace_object_history, manage_labels, query_events, check_activity, get_top_holders, compare_oracle_price, aggregate_events, save_finding, list_findings, export_case, delete_finding
'developer' — Move package analysis — modules, disassembly, decompilation, upgrade diffing, dependency graphs, PTB decoding, unsigned transaction building, Move Registry. Tools: get_package, get_move_function, get_package_dependency_graph, analyze_package, disassemble_module, decompile_module, diff_package_upgrade, decode_ptb, simulate_transaction, build_transfer, build_staking, get_checkpoint, list_dynamic_fields, mvr_resolve, mvr_reverse_resolve, mvr_get_package_info, mvr_search, mvr_resolve_struct
'market' — Market data — DeepBook order book and fills, pool stats, token search, validators. Tools: deepbook_orderbook, deepbook_trades, get_pool_stats, search_token, get_coin_info, get_validators

Use 'all' for eve…

Input parameters:

- `profile` (required): Profile to enable, or 'all'.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp#diagnostics

## Score history

- 2026-08-12: 83
- 2026-08-11: 82
- 2026-08-10: 70
- 2026-08-09: 80
- 2026-08-08: 80
- 2026-08-07: 39

## Links

- npm package: https://www.npmjs.com/package/sui-analytics-mcp
- Socket report: https://socket.dev/npm/package/sui-analytics-mcp
- Repository: https://github.com/0xfreak0/sui-mcp
- Changelog RSS feed: https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp.json
- HTML version of this page: https://verifymcp.io/servers/0xfreak0-sui-mcp/sui-analytics-mcp