# Suivision MCP > Suivision (Sui Blockchain Explorer API) MCP Server lets your AI agent query the Sui network directly. You get real-time data for accounts, transactions, objects, and smart contracts—all without hitting a web explorer. Use tools like `get_account_overview` to check balances or `list_transactions` to track recent activity instantly. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** sui-network, blockchain-explorer, web3-data, smart-contracts, crypto-tracking ## Description Forget copy-pasting data out of some clunky web explorer. This server lets your AI agent talk straight to the Sui network, giving you real-time access to every transaction, object, and smart contract package without needing a browser open. It's raw blockchain data—fast, actionable, and right in your client. ### Account Status Checks Want to know what an address is sitting on? You can run `get_account_overview` to get a summary view of any Sui address; that tells you the current coin balances and how many objects it holds. For specifics, use `get_account_coins` to list every single type of coin owned by that address. If you need to see what non-coin assets—like NFTs or specific tokens—it owns, run `get_account_objects`. You can also check the entire history for a given account using `get_account_transactions`, which lists every transaction involving that address. ### Tracking Transactions and Assets You don't have to manually scroll through pages of activity. Use `list_transactions` to pull in multiple recent network actions, supporting pagination and filtering so you can nail down exactly what happened and when. Need the full story on one specific event? Run `get_transaction` using a transaction digest; that fetches comprehensive data detailing all inputs and outputs for that single move. To track assets broadly across the system, use `list_cookies` to see recent network activity or get deep details about any specific object ID with `get_object_details`, which shows its full metadata and properties. ### Smart Contract Deep Dive This server lets you treat smart contracts like code. You can pull all the definition details, bytecode, and package structure for a Move smart contract using `get_package_details`. To see how that contract has been used, run `get_package_transactions` to list every transaction that interacted with or called that specific package. When analyzing assets across the board, you can calculate the total circulating supply of any coin type via `get_coin_supply`, and grab basic supply data and decimals for a defined coin using `get_coin_metadata`. You'll also get aggregated stats on DeFi activity using `get_defi_stats`. ### Network State and History Auditing You can monitor the foundational health of the network. Use `list_checkpoints` to get a list of the most recent technical snapshot checkpoints, or run `get_checkpoint` for the specific details about one checkpoint. Want to look back at history? You can call `list_epochs` to see all recently closed and active epoch periods in Sui's timeline, or use `get_epoch` to fetch specifics on a given period. To understand who's running the show, you run `list_validators`, which gives you a list of every current validator participating in the consensus layer. ## Tools ### get_account_coins Lists every coin type owned by a specific Sui account address. ### get_account_objects Retrieves a list of all on-chain objects (like NFTs) associated with an account. ### get_account_overview Provides a summary view of a Sui address, including current coin balances and object counts. ### get_account_transactions Lists all transactions that have involved a specified account address. ### get_checkpoint Fetches technical details about a specific network checkpoint snapshot. ### get_coin_metadata Retrieves supply data and decimals for any defined coin type on the Sui network. ### get_coin_supply Calculates and returns the total circulating supply for a given coin type. ### get_defi_stats Retrieves aggregated statistics related to DeFi activity on the Sui network. ### get_epoch Provides details about a specific epoch period in the network's history. ### get_object_details Gets full metadata and properties for a specific, identified on-chain object ID. ### get_package_details Retrieves the bytecode, package structure, and definition details for a Move smart contract package. ### get_package_transactions Lists all transactions that have interacted with or called a specific smart contract package. ### get_transaction Fetches comprehensive data, including inputs and outputs, for one transaction digest. ### list_checkpoints Gets a list of the most recent network checkpoint snapshots available on the chain. ### list_epochs Lists all recently closed and active epoch periods in the Sui network history. ### list_transactions Lists multiple recent transactions on the Sui network, supporting pagination and filtering. ### list_validators Retrieves a list of all current validators participating in the Sui consensus layer. ## Prompt Examples **Prompt:** ``` List the last 5 transactions on the Sui network. ``` **Response:** ``` I've retrieved the latest activity. Recent transactions include digests like `5A2b...` and `8Xz9...`. Would you like me to inspect the details of the most recent one? ``` **Prompt:** ``` What are the coin balances for the address 0x123...? ``` **Response:** ``` Checking the account... This address holds 150.5 SUI and 2,000 USDC. I also found 3 other minor coin types. Should I list the metadata for these coins? ``` **Prompt:** ``` Get the metadata and supply for the SUI coin type. ``` **Response:** ``` The SUI coin (0x2::sui::SUI) has 9 decimals. The current total supply is approximately 10 billion. Is there another coin type you'd like to analyze? ``` ## Capabilities ### Query Account Status Retrieve an account's current balance, owned objects (NFTs), and transaction history using tools like `get_account_overview`. ### Track Transactions List recent network activity or get full details on a specific transaction digest via `list_transactions` or `get_transaction`. ### Analyze Smart Contracts Inspect Move packages to view bytecode, package details, and which transactions interacted with them using `get_package_details`. ### Audit Assets and Coins Determine total coin supply (`get_coin_supply`) or check metadata for any specific asset type on the Sui network via `get_coin_metadata`. ### Inspect On-Chain Objects Get detailed information about specific objects (like assets) owned by an address using `get_object_details`. ## Use Cases ### Investigating a 'Whale' Movement A quant sees unusual activity. They ask their agent: 'Get the overview for 0xABCD, then list all transactions.' The agent runs `get_account_overview` and `get_account_transactions`, showing the initial balance drop and pointing to a specific transaction digest they need to check. ### Debugging Contract Interaction A developer suspects a package is failing. They ask: 'What packages interacted with 0x123?' The agent runs `get_package_transactions`, listing all calls, and then uses `get_transaction` on the most suspicious hash to see the exact input data. ### Checking Asset Ownership A user wants to confirm they own a specific NFT. They ask: 'Show me objects for address 0xEFGH.' The agent uses `get_account_objects` and then runs `get_object_details` on the resulting object ID, confirming its type and metadata. ### Tracking Coin Supply Changes A researcher needs to know if a coin's total supply changed recently. They first run `list_checkpoints` to establish a timeline, then use `get_coin_supply` multiple times against different checkpoints to map the historical change. ## Benefits - Stop checking multiple UIs. Use `get_account_overview` to get a single summary of an address's coins and objects—it saves the round trip through separate coin and asset pages. - Analyze complex contracts quickly. Instead of reading raw bytecode, use `get_package_details` to pull out the Move package structure directly into your workflow for validation. - Track all movements at once. Running `list_transactions` gives you paginated access to recent network events, letting you filter and analyze activity without hitting rate limits or losing context. - Build a complete financial picture. Combine `get_defi_stats` with specific account queries to model total value locked (TVL) for an asset class—all from one prompt. - Verify ownership instantly. Use `get_object_details` when you find an object hash, getting the full metadata right away instead of having to look up its type elsewhere. ## How It Works The bottom line is: your AI client handles the complex API calls, so you just write a natural language query. 1. Subscribe to the Suivision API server and provide your unique Suivision API Key. 2. Tell your AI client (Claude, Cursor, etc.) what data you need—e.g., 'What coins does this address own?' 3. Your agent runs the correct tool (like `get_account_coins`) against the live Sui network and returns structured JSON data. ## Frequently Asked Questions **How do I check an account balance and its NFTs using get_account_overview?** The `get_account_overview` tool gives a summary including both coin balances and object counts. If you need the actual list of NFT IDs, run `get_account_objects` separately for full details. **What is the difference between get_transaction and list_transactions?** `list_transactions` shows a batch of recent activity across the network. Use `get_transaction` when you have a specific digest or hash and need its full, deep payload details. **Can I track an asset's history using get_object_details?** No. `get_object_details` gives the current state of one object. To see its historical interactions, you must use `get_package_transactions` if it belongs to a package. **How do I find out about all coins on Sui?** You start with `list_checkpoints` or `list_epochs` to understand the network state. Then, use `get_coin_metadata` for specific coin types and `get_coin_supply` for their total amount. **What credentials do I need to use `get_account_overview` for a specific address?** You must pass a valid API Key with your request headers. The key authenticates your AI client and tracks usage, ensuring you stay within the network's operational rate limits. **Using `get_package_details`, how can I analyze the internal structure of a smart contract?** The tool returns comprehensive details on the Move package, including its bytecode and all dependencies. You get visibility into the code's required inputs and outputs without needing to interact with the live blockchain. **How does `get_checkpoint` help me analyze state changes over time?** It fetches data from specific historical snapshots of the network. You can compare account balances or object ownership as they existed at a precise point in time, which is critical for auditing and tracking past events. **If I hit rate limits when calling `list_transactions`, what should my AI agent do?** The client will receive an explicit HTTP error code (usually 429). Your agent needs to implement an exponential backoff strategy, pausing and retrying the query after a progressively longer interval. **Can I check the balance and owned objects of a specific Sui address?** Yes! Use the `get_account_overview` tool to see the general balance or `get_account_objects` to list all objects, including NFTs, associated with that address. **How do I get the technical details of a specific transaction digest?** Simply provide the transaction hash to the `get_transaction` tool. It will return the sender, gas usage, status, and execution effects. **Can I inspect the source code or modules of a Move package?** Yes, use the `get_package_details` tool with the Package ID. It retrieves the Move bytecode and module information directly from the blockchain.