{"report":"{\"v\":1,\"package\":\"sui-analytics-mcp\",\"version\":\"1.29.0\",\"ranAt\":\"2026-11-16T11:46:03.886Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-3gyd6KhvLB585KZU9g9nShOENNCoyJSFITldp+HdbJPtc++peMepEpJal/+pKJg21dUOsx0R9oZii1kTdCFWmg==\",\"deps\":155,\"scripts\":[\"protobufjs\"],\"bins\":[\"sui-analytics-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=22.13.0\",\"repository\":\"https://github.com/0xfreak0/sui-mcp.git\",\"bin\":\"sui-analytics-mcp\"},\"start\":{\"ok\":true,\"ms\":592,\"serverName\":\"sui-mcp\",\"serverVersion\":\"1.29.0\",\"protocol\":\"2025-06-18\"},\"tools\":[{\"name\":\"get_chain_info\",\"description\":\"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.\",\"params\":[\"epoch\",\"network\"]},{\"name\":\"get_object\",\"description\":\"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. For the LATEST version it also lists `address_balances` (funds the object holds in its own address balance, which are not among its fields and which only its defining module can withdraw) and, for a kiosk, `kiosk_cap_holder`: who actually controls it today, since `content.owner` is self-declared and not kept in sync with the KioskOwnerCap transfer that does. Neither is read for a specific `version`: both are current state and would misname a past snapshot's controller.\",\"params\":[\"object_id\",\"version\",\"balance_cursor\",\"kiosk_scan_pages\",\"kiosk_wrap_steps\",\"network\"]},{\"name\":\"list_owned_objects\",\"description\":\"List raw objects owned by a Sui address with optional type filter and pagination. `count` covers every object of the page; the default view lists the objects that fit about 30k characters in page order and states the rest under `omitted`, and `detail: 'full'` lists the whole page. `next_cursor` continues after the whole page, rows under `omitted` included. For NFTs specifically, prefer list_nfts (resolves kiosk storage, extracts display metadata). For a wallet summary, prefer get_wallet_overview.\",\"params\":[\"owner\",\"address\",\"object_type\",\"limit\",\"cursor\",\"detail\",\"network\"]},{\"name\":\"get_balance\",\"description\":\"Read one coin's liquid balance for a Sui address or object, now or at a past time/checkpoint; the default coin is SUI. The total includes Coin<T> objects and address-balance funds, so no coin objects does not mean no funds. Only its defining module can withdraw an object's address balance. This excludes staking and DeFi positions: check get_staking_summary and get_defi_positions before assessing holdings; use get_wallet_overview for every coin. Historical reads are direct within the consistent range (about the last hour), reconstructed for older points and exact only when complete:true. Reconstruction stops at max_transactions; an incomplete result has balance:null and reached_checkpoint marks progress. Reconstructed coin_balance and address_balance are null; anchor has the split at its checkpoint.\",\"params\":[\"owner\",\"address\",\"coin_type\",\"at_checkpoint\",\"at\",\"max_transactions\",\"network\"]},{\"name\":\"get_transaction\",\"description\":\"Read one Sui transaction's sender, status, gas, balance changes, decoded actions and event fields; no hand-written GraphQL is needed to read event values. It identifies protocols from calls and events (including wrappers), and unnamed packages by their curated publishing key; protocols_unchecked marks unread publishers. It shows address-balance deposits and withdrawals, requested withdrawals and gas source; non-sender object deliveries (coins separately when no other object moved); sender-owned capabilities mutated without transfer; and router coin round trips with cost from pool events, or null with a reason. High-bit u256 event numbers get signed readings; full detail also gives two's-complement readings of high-bit u64/u128/u256 pure values. Use detail:'full' for inputs with declared types and object versions, resolved command arguments and Result origins, and every changed object's ID, type and version by kind. Summary may fold or cap event rows past ~20k chars, retaining events emitted by called non-framework packages; omitted reports reductions. Full detail lists all events in pages: follow events_page.next_call. For command-only or pre-sign inspection use decode_ptb; for exploit profit, state deltas and anomaly leads use analyze_attack_tx.\",\"params\":[\"digest\",\"max_event_field_bytes\",\"detail\",\"commands\",\"event_offset\",\"network\"]},{\"name\":\"get_transactions\",\"description\":\"Read 1-50 transaction digests in batched calls. Returns sender, status, timing, balance changes, non-coin object transfers and objects created for other owners, Move calls, decoded events and protocols. GraphQL misses are retried through the archive. object_changes_truncated marks an incomplete bounded object read; use get_transaction for that digest. Summary caps displayed rows with counts and omitted retrieval; detail: 'full' removes display caps, not object or event read bounds.\",\"params\":[\"digests\",\"detail\",\"network\"]},{\"name\":\"query_transactions\",\"description\":\"Query raw transactions by sender, affected address or object, Move function, or time/checkpoint range. Pass ISO 8601 times directly in after_checkpoint and before_checkpoint, e.g. \\\"2026-08-07T00:00:00Z\\\"; checkpoint numbers are optional. Only one of affected_address, affected_object and function is allowed. Prefer get_transaction_history for readable wallet activity. Pages default to newest first and report order, timestamp bounds and resolved window; pass next_cursor as cursor with the same order and filters. Short service pages are filled to limit within a read budget; scan reports exhaustion and the continuation call. Continue while has_next_page, even with no transactions. A function filter covers only the named package version; function_scope names other versions and all_versions:true merges the whole lineage. Rows wait for each stream's next rows or exhaustion to establish global order. It matches any PTB containing the call, even one leg among several protocols. Whole-PTB balance changes therefore over-attribute protocol volume. Use include_functions to inspect every Move call, and query_events for a protocol's own flow.\",\"params\":[\"sender\",\"affected_address\",\"affected_object\",\"function\",\"after_checkpoint\",\"before_checkpoint\",\"order\",\"limit\",\"cursor\",\"include_functions\",\"all_versions\",\"network\"]},{\"name\":\"resolve_name\",\"description\":\"Resolve a SuiNS name (.sui domain) to an address, or reverse-lookup an address to its SuiNS name. Provide 'name' or 'address'. An unregistered, expired or unset name returns a null address with `name_note`; a malformed name is an error.\\n\\nIDENTITY WARNING: Anyone can buy a SuiNS name. A name matching an exchange, project or person may belong to an unrelated party, including one that wants to mislead an investigator. Treat it as a holder-chosen label, not verified identity; corroborate independently before matching it to identities on other platforms.\",\"params\":[\"name\",\"address\",\"network\"]},{\"name\":\"get_wallet_overview\",\"description\":\"(Recommended first tool for wallets) Overview of a Sui wallet: every coin balance, SuiNS name, staked SUI and kiosk counts, 50 newest transactions with an older-history continuation, and a time-bounded scan of package versions it published or upgraded in the first 20 sent transactions (`package_activity.scan.next_call` continues; `package_activity_next_call` retries if unavailable). include_prices adds USD values, coins ranked by value, and DeFi positions (staked SUI with rewards, liquid staking, liquidity, lending, and balances inside owned objects), each totalled apart. `coverage` says which owned objects the total covers and lists unrecognised types with counts; `leads` names lending positions near their borrow limit and shared vaults the wallet operates, with what they hold. include_nfts adds NFT estimates, kept out of the total.\",\"params\":[\"address\",\"include_prices\",\"include_nfts\",\"balance_cursor\",\"owned_max_scan\",\"nft_max_collections\",\"nft_market_depth\",\"operated_recent_limit\",\"operated_candidate_limit\",\"operated_cursor\",\"detail\",\"network\"]},{\"name\":\"get_wallet_packages\",\"description\":\"List package versions created by publish or upgrade transactions sent from this wallet address. Scans 20 sent transactions per call, oldest first; `scan.complete` is true only when all pages and transactions were read. `scan.next_call` continues with an opaque cursor that carries prior unread counts. `scan.incomplete_transactions` names unread digests on this page and `scan.prior_incomplete_transactions` counts them on earlier pages. Each package carries its creating transaction, lineage root and version; an alias may have signed for the sender, and the sender is not necessarily the current UpgradeCap holder.\",\"params\":[\"address\",\"cursor\",\"network\"]},{\"name\":\"get_token_prices\",\"description\":\"Get USD prices for Sui coins by full coin type, current by default or at a past moment when `at` is set. Needs no API key. Each price names its source, confidence and sample time, and each coin that could not be priced is listed under `unpriced` with the reason. The 24h change is null when DefiLlama lacks the current or day-earlier price. An unverified coin is priced only by its exact coin type, never by a symbol-matched feed.\",\"params\":[\"coin_types\",\"at\",\"network\"]},{\"name\":\"get_defi_positions\",\"description\":\"Find and value a wallet's staked SUI with rewards, issuer-rate liquid-staking coins, CLMM/AMM liquidity, lending and balances inside owned objects. Positions include asset legs, valuation method and evidence tier; USD is null if any leg lacks a price, with unpriced_reason. Totals sum only priced positions. coverage lists unrecognised owned-object types and counts; unread lists failed reads. Lending includes protocol health ratios. leads flags near-borrow-limit positions and operated shared vaults with their holdings.\",\"params\":[\"address\",\"owned_max_scan\",\"operated_recent_limit\",\"operated_candidate_limit\",\"operated_cursor\",\"detail\",\"network\"]},{\"name\":\"list_nfts\",\"description\":\"(Recommended for NFTs) List NFTs owned by a wallet, including kiosk-stored NFTs. Each row has an object id, `collection_ref` (zero-based index into this page's exact `collection_types`), kiosk and display metadata. `detail: 'full'` adds raw Move contents and valuation evidence. `est_usd` is a heuristic NFT estimate; other valued objects carry `value_usd` and a tier. `value: false` skips valuation. Pass `next_cursor` as `cursor` for the next page; its absence means the wallet is fully enumerated. Use list_nft_collections for a per-collection summary and wallet total.\",\"params\":[\"address\",\"limit\",\"cursor\",\"detail\",\"value\",\"max_collections\",\"market_depth\",\"network\"]},{\"name\":\"list_nft_collections\",\"description\":\"Summary of the NFT collections a wallet holds: every kiosk plus directly owned objects, one row per collection type with its count. Each collection carries an estimated value (tier heuristic): per item, the lower of the collection's lowest active listing and its last sale in the 30 days before now, or whichever of the two exists (a listing alone only if placed in that window), with zero-price sales, sales within one address or kiosk, and sales where one side first funded the other left out; unpriced otherwise. `estimated_value` totals every collection; the default view keeps every priced collection and caps the rest, and `detail: 'full'` returns all rows. `value: false` skips the valuation.\",\"params\":[\"address\",\"value\",\"max_collections\",\"market_depth\",\"detail\",\"network\"]},{\"name\":\"get_staking_summary\",\"description\":\"Get directly held StakedSui positions and principal, now or at as_of. Historical budget stops return a continuation; totals stay null until replay finishes. Excludes wrapped stakes and liquid-staking tokens.\",\"params\":[\"address\",\"as_of\",\"max_transactions\",\"max_positions\",\"position_cursor\",\"continuation\",\"detail\",\"network\"]},{\"name\":\"get_transaction_history\",\"description\":\"(Recommended for wallet activity) Read a wallet's decoded protocols, actions and coin flows; prefer this to query_transactions for exploring activity. from/to bound the chain query: ISO times are inclusive, checkpoint numbers exclusive. Rows use complete balance changes and commands. Newest first by default; oldest starts at the first transaction in the window. Pass next_cursor as cursor with the same from, to and order. address_poisoning always checks the shown page only, so empty pairs clear nothing older. subject_flow is the queried wallet's signed change per coin; token_flow is the sender's, omitted when they are the same address. Counterparties include at most 25 value recipients; counterparty_count reports larger sets. Summary keeps ~35k characters, preserving failed and lookalike-involved rows; omitted reports the rest and detail:'full' lists the whole page. signed_as_alias separately lists transactions signed as another wallet's address_alias delegate, which the main page cannot show. The delegate scan is cached for up to five minutes; alias_scan_as_of dates it and signed_as_alias_unavailable marks incomplete scans, even beside returned matches.\",\"params\":[\"address\",\"from\",\"to\",\"limit\",\"order\",\"cursor\",\"detail\",\"network\"]},{\"name\":\"find_pools\",\"description\":\"Find pools for an exact token pair across 11 Sui venues. Both token orders are searched. Incomplete venue searches carry a next_call that resumes from their last cursor; offset pages the pools found in one call. Totals are lower bounds until every venue completes.\",\"params\":[\"token_a\",\"token_b\",\"protocol\",\"offset\",\"venue_cursor\",\"network\"]},{\"name\":\"identify_address\",\"description\":\"(Recommended first step) Classify a Sui address as wallet, package, validator or object before choosing other tools. For wallets, package_activity scans the first 20 sent transactions for publishes/upgrades and provides next_call to continue; the result also includes balance and name context. Package results include modules and bridge labels on defined objects; bridge_carrier identifies bytecode calls into curated bridge exits. Validator results include stake information. A wallet's first_seen is the oldest transaction GraphQL returns where it sent or was affected, with received coins read across all balance-change pages. first_inflow means it gained coins without sending, including genesis with sender:null; genesis names no funding wallet. Incomplete balance changes with no observed gain leave first_inflow null. first_seen_unavailable marks a failed first read. Use find_funding_sources when the first transaction was only a token airdrop.\",\"params\":[\"address\",\"network\"]},{\"name\":\"analyze_token\",\"description\":\"(Recommended for token research) Analyze a Sui coin type or symbol: metadata, current price, 24h change, supply, top holders and current pool-liquidity custody. Verified symbols resolve from the curated list; other mainnet symbols use DexScreener and GeckoTerminal searches confirmed on chain, several exact matches return ambiguous_symbol, and a provider cap or failed confirmation is reported, not read as an absent coin. Pool search covers SUI and native-USDC pairs with per-venue failure reporting. Liquidity custody scans the three pools with the largest SUI or USDC reserve; a stopped holder scan never establishes ownership concentration. Set include_liquidity false to skip pool reads.\",\"params\":[\"query\",\"include_holders\",\"holder_max_scan\",\"holder_time_budget_ms\",\"include_liquidity\",\"liquidity_pool_offset\",\"liquidity_holder_pool\",\"liquidity_offset\",\"liquidity_flagged_done\",\"liquidity_max_scan\",\"liquidity_time_budget_ms\",\"liquidity_venue\",\"liquidity_venue_cursor\",\"network\"]},{\"name\":\"enable_tools\",\"description\":\"Turn on more Sui tool profiles for this session. When a tool you need is not in your list, call this first: it is disabled, not missing. Do not rebuild a tool by hand. Pass `profile` or `profiles`: one name, several, or 'all'. Enabled tools are callable at once.\\n\\n'forensics' (incident investigation: tracing, attribution, clustering, packages, labels, case findings): resolve_protocol_packages, sample_control_addresses, trace_funds, trace_flow_graph, find_flow_path, resolve_bridge_transfer, find_funding_source, find_funding_sources, get_address_fanout, classify_deposit_address, screen_address, analyze_launch, build_wallet_edges, analyze_multisig, find_shared_multisig, check_coin_restrictions, analyze_package, get_package, get_move_function, disassemble_module, build_timeline, trace_object_history, get_upgrade_history, manage_labels, query_events, check_activity, get_top_holders, list_objects_by_type, compare_oracle_price, analyze_attack_tx, summarize_incident_losses, summarize_address_flows, aggregate_events, save_finding, list_findings, export_case, delete_finding, watch_addresses, poll_watch, get_nft_sales\\n'developer' (Move packages, bytecode, upgrades, PTBs, unsigned transactions, MVR): get_package_dependency_graph, 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\\n'market' (DeepBook, pools, token search, validators): deepbook_orderbook, deepbook_trades, get_pool_stats, search_token, get_coin_info, get_validators\\nOn: core.\",\"params\":[\"profile\",\"profiles\"]}],\"toolsHash\":\"3ea547144a6d6ff2beebfce4c39492dbf4ec5b4ac60eda8d2816f743d183ca6b\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:46:13.972Z\",\"calls\":[{\"tool\":\"get_chain_info\",\"ok\":true,\"ms\":362,\"bytes\":323},{\"tool\":\"list_owned_objects\",\"ok\":false,\"ms\":2,\"bytes\":0,\"error\":\"tool reported an error: {\\\"error\\\":\\\"Pass the wallet to list as `owner` (or `address`).\\\"}\"},{\"tool\":\"get_balance\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: {\\\"error\\\":\\\"Pass the wallet to read as `owner` (or `address`).\\\"}\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[\"fullnode.mainnet.sui.io\"],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmJkYWM4YWRhZjUwOTMzYzAzYWFkYWNlMzc4ZWY2MjM2MTdkYjE3OGY0ODU0MTU3MTQyZmM2OWQ5NTY2MTM2NDAiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTk0NSIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTg4MSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk1ODEsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiNjRiODliM2UtMjM5Yy00ZjYwLTg3YTktOGI1MWM4YmEyY2M0IiwibmJmIjoxNzk0ODI5MjgxLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.zc0jsrfRmPn6UFE3MR3D-v9eeT60CtNPFRvIieznOq-9y7BEq4BW4V9pd1uNHp_HP-OWWhtNhb4AG8TRSAY_Ci5FVBZ1T07EvNqvdhplKJko383CPjnl347O28AeSuLHn-la0eKqcLX6dxVyVmn8A7-JDLRo0z-pgs2YBU-hstvWd88Pq1yRVGRKLbPNmaF6orMu9gnDFTDD6W0U3T0QlVjdx8w9zZPpH1JeGKaoDDGK47NKHvqmQcLgsmlnEhrbQJijw58q4MrYpZjTyfTXJfB9ln4dLF2Wr_Pe7WFnKqonRTdKOf14GLezicffCvm4zkq7t3HxjJGm9seDnopl8Q"}