Aptoscan MCP. Read live account state and asset holdings directly in your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Aptoscan (Aptos Blockchain Explorer API) lets your agent query the Aptos blockchain directly. Check account balances, list owned tokens (NFTs/fungible assets), track transaction history, and inspect raw Move module data without leaving your chat interface.
It’s a live API connection for deep on-chain data analysis.
What your AI agents can do
Get account balance
Gets the current native currency balance for a specified account address.
Get account modules
Lists all Move modules published under a specific account address.
Get account resources
Retrieves every resource owned by the specified account.
Determines the current balance of a specified Aptos account address.
Retrieves all tokens—NFTs and fungible assets—that an account holds.
Gets a list of all transactions associated with a specific account address.
Retrieves full block data based on either its block height or its transaction version.
Fetches detailed metadata and supply information for a specific token identifier.
Lists all Move modules that have been published under a given account address.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Aptoscan (Aptos Blockchain Explorer API) - 10 Tools
These tools let you query the Aptos blockchain to pull account balances, token lists, transaction histories, and block details into your conversational workflow.
019e5cfcget account balance
Gets the current native currency balance for a specified account address.
019e5cfcget account modules
Lists all Move modules published under a specific account address.
019e5cfcget account resources
Retrieves every resource owned by the specified account.
019e5cfcget account tokens
Lists all NFTs and fungible assets held by a given account.
019e5cfcget account transactions
Gets a complete list of all transactions associated with a specific account.
019e5cfcget block by height
Retrieves all details for a block based on its numerical height.
019e5cfcget block by version
Gets block details by referencing a specific transaction version number.
019e5cfcget token data
Fetches metadata and supply info for a specific token ID.
019e5cfcget transaction by hash
Gets all details for a transaction using its unique transaction hash.
019e5cfcget transaction by version
Gets all details for a transaction using its ledger version number.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Aptoscan (Aptos Blockchain Explorer API), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Yo, this Aptoscan API lets your agent pull data straight from the Aptos blockchain. You can check account balances, list all assets, track transactions, and even look at raw Move module code, all without leaving your chat window.
Checking Accounts: You'll use
get_account_balanceto get the current native currency balance for any address. You can also runget_account_tokensto list every NFT and fungible asset an account holds, orget_account_resourcesto see everything else the account owns. To check the raw smart contract logic, useget_account_modulesto list all Move modules published under an address.Finally,
get_account_transactionsgives you a full history of all transactions linked to an account.Tracking Transactions: You can get all details for a transaction using its unique hash with
get_transaction_by_hash, or you can useget_transaction_by_versionif you know the ledger version number.Inspecting Blocks: Need to see what happened at a specific point in time? Use
get_block_by_heightto pull all details for a block based on its numerical height. You can also get block details by referencing a specific transaction version number usingget_block_by_version.Token Deep Dive: To get the scoop on a token,
get_token_datafetches its metadata and supply information based on a specific token ID. If you just want to see what assets an account has,get_account_tokenshandles that.
This thing lets you analyze deep on-chain data instantly.
How Aptoscan MCP Works
- 1 First, subscribe to the server and input your personal Aptoscan API Key.
- 2 Then, ask your AI client for the specific data point you need (e.g., 'What is the balance of 0xabc...?').
- 3 Your agent calls the appropriate tool, which retrieves the live data from the Aptos ledger and delivers the result back to your chat.
The bottom line is you get real-time, deep blockchain data without ever opening a web browser.
Who Is Aptoscan MCP For?
The data analyst who needs to validate on-chain assets without leaving their IDE. The web3 developer debugging a failed smart contract deployment. The crypto researcher needing to track complex transaction flows across multiple wallets. If your job involves reading the blockchain state, you need this.
Debugging failed transactions or inspecting account resources without switching tabs or running local scripts.
Pulling specific on-chain data (like token counts or block heights) directly into a structured report or workflow.
Monitoring wallet balances and tracing complex transaction paths across multiple accounts for market intelligence.
What Changes When You Connect
- Track asset movements in real time. Use
get_account_tokensto list every NFT and fungible asset an account holds. You don't have to open a wallet explorer just to count the collection size. - Diagnose failed smart contracts. Developers use
get_account_resourcesandget_account_modulesto see exactly what state an account was in before a transaction failed. This saves hours of debugging. - Audit block activity instantly. Need to know what happened at block height 5000000? Call
get_block_by_heightto get the full block contents and transaction count immediately. - Trace specific transactions. If a user complains about a transfer, use
get_transaction_by_hash. You get the full audit trail—who, when, and what—without guessing. - Pull structured data into workflows. Instead of copy-pasting raw data, your agent uses
get_account_balanceandget_account_transactionsto output clean, structured JSON ready for your analysis script. - Understand token specifics. Use
get_token_datato pull the official metadata and total supply for a token, cross-referencing it against the account's holdings.
Real-World Use Cases
Investigating a suspicious transfer
A crypto researcher spots an unusual transaction. Instead of opening a web explorer and manually searching by hash, they ask their agent: 'What happened with this transfer?' The agent runs get_transaction_by_hash, pulling the full, verified details right into the chat, solving the investigation instantly.
Validating contract deployment state
A developer just deployed a smart contract. To verify the setup, they ask the agent to run get_account_modules and get_account_resources on the new contract's address. The agent returns a list of published modules and resources, confirming the deployment state before any user funds are moved.
Checking a high-value wallet's assets
A data analyst needs a quick snapshot of a whale wallet. They prompt the agent to run get_account_tokens and get_account_balance. The agent returns a clean list of all NFTs and the current APT balance in one go, feeding the data directly into their current analysis sheet.
Auditing network activity by block
A compliance officer needs to audit all activity around a specific time frame. They ask the agent to check get_block_by_height for block 12345. The agent provides the full block data, allowing the officer to verify every transaction and resource change in that specific ledger window.
The Tradeoffs
Manually stitching together account info
Copying the address from a block explorer, then opening a second tab to check the balance, and a third tab to list tokens. This is slow, error-prone, and requires context switching.
→
Keep everything in your chat. Ask your agent to run get_account_balance and get_account_tokens back-to-back. You get the full picture—balance and assets—in one conversational turn.
Assuming simple read operations are enough
Just running get_account_balance and assuming that tells you the full story about resource usage. You miss the published modules or complex resource constraints.
→
Always check the full state. Run get_account_resources or get_account_modules alongside the balance check to get the complete operational picture of the account.
Using the wrong identifier for transactions
Trying to look up a transaction using a block height when the data is only available via a specific transaction hash, or vice versa.
→
Know your identifiers. Use get_transaction_by_hash for the unique hash, or get_transaction_by_version if you need to query by a specific ledger version number.
When It Fits, When It Doesn't
Use this if you need real-time, verifiable state data from the Aptos blockchain and your workflow is already chat-based (e.g., inside an IDE or a messaging client). You need to check balances, list assets, or trace transactions using specific identifiers (hashes, heights).
Don't use this if you are trying to build a general-purpose database or need to write data back to the chain. This is a read-only data service. If you only need a very high-level, aggregated view that doesn't require specific tool calls, a simple REST API might suffice, but you lose the conversational context and the depth of the raw data provided by tools like get_account_resources.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Aptoscan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking on-chain state used to mean clicking through five different dashboards.
Before this server, checking an account's full status meant hopping between the main block explorer, the asset list, the transaction history, and the dedicated module viewer. You'd copy an address, paste it in five different places, and manually piece together the balance, the owned tokens, and the recent activity.
Now, your agent handles it. You ask, 'What's the status of 0x123?' and it runs multiple tools—`get_account_balance`, `get_account_tokens`, `get_account_resources`—and gives you a single, comprehensive data dump in your chat. It's all there.
Aptoscan MCP Server: Get the full account picture instantly
The complexity of manually querying transactions is gone. Instead of navigating to a hash lookup page, then digging into the block details, you just ask for the transaction using `get_transaction_by_hash` or `get_transaction_by_version`. The agent pulls the full, structured data right away.
You don't just get a 'yes' or 'no.' You get the raw data, the specific ledger versions, and the full context you need to write code or make a decision. That's the difference.
Common Questions About Aptoscan MCP
How do I use the `get_account_balance` tool with my Aptos address? +
You provide the target Aptos address as the argument. The tool returns the current native currency balance for that specific address.
Can I find all my tokens using the `get_account_tokens` tool? +
Yes, this tool lists all assets held by the account, covering both NFTs and fungible tokens. It gives you a complete list of everything the wallet owns.
What's the difference between `get_transaction_by_hash` and `get_transaction_by_version`? +
Use get_transaction_by_hash if you have the unique transaction identifier. Use get_transaction_by_version if you know the ledger version where the transaction occurred.
Does the `get_block_by_height` tool show all transactions? +
Yes, it returns the full block data, including all contained transactions, allowing you to audit everything that happened at that specific height.
Is the `get_account_resources` tool for NFTs? +
No. get_account_resources lists the underlying system resources and modules. Use get_account_tokens for NFTs and fungible assets.
How do I use `get_account_transactions` to list transactions for an entire range of addresses? +
No single tool handles a range of addresses. You must first get a list of addresses and then call get_account_transactions for each one individually. This approach ensures you capture all necessary data points.
What information does `get_account_modules` provide about a specific account? +
get_account_modules returns a list of Move modules published under that address. This lets you analyze the smart contract logic associated with the account, going beyond just asset balances.
If a transaction fails, how can I check the error details using `get_transaction_by_hash`? +
The response from get_transaction_by_hash includes detailed failure reasons. Look for the 'status' or 'error message' field in the returned JSON object for the specific failure details.
How do I check the balance of a specific Aptos wallet? +
Use the get_account_balance tool by providing the Aptos account address. The agent will return the current balance of that account immediately.
Can I see all NFTs and tokens owned by an address? +
Yes! The get_account_tokens tool lists all tokens, including NFTs and Fungible Assets, associated with a specific Aptos address.
How can I look up the details of a transaction if I have the hash? +
Simply use the get_transaction_by_hash tool with the transaction hash. It will retrieve full details including status, sender, and payload.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Timezone Offset Engine
Calculate the exact offset between two timezones at any moment, with full DST awareness. Powered by Luxon.
Deepgram
Power audio AI via Deepgram — perform high-speed speech-to-text, generate lifelike text-to-speech, track usage, and manage API keys directly from any AI agent.
Langflow (Visual Multi-agent Orchestrator)
Orchestrate multi-agent AI workflows visually — execute flows, manage projects, and trigger webhooks directly from any AI agent.
You might also like
Lyft
AI ride management: request rides, estimate costs, and track trips via agents.
Google Cloud Logging Stream
This MCP does exactly one thing: it queries logs using Google Cloud Logging. That's its only function, and nothing else. Incredible for giving your AI secure observability.
Mercado Livre Catalog
Create, update, and manage product listings, stock, and prices on Mercado Livre.