Celoscan MCP. Audit Celo asset movements and contract code.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Celoscan (Celo Network Explorer) instantly checks Celo network data for any AI agent. Pull account balances, track every ERC20 and NFT transfer event, and inspect smart contract code directly from your chat interface.
What your AI agents can do
Get account balance
Gets the CELO balance for a single address.
Get account balance multi
Gets the CELO balance for several addresses at once.
Get block countdown
Estimates how long until the next block is mined, based on a specific block number.
Instantly determines the CELO balance for one or multiple addresses.
Retrieves lists of ERC20 and ERC721 (NFT) transfers associated with a specific address.
Lists all internal transactions for an address, showing deeper contract-level activity.
Pulls the ABI and source code from verified smart contracts for technical review.
Checks current block countdown times, mined blocks by address, or transaction receipt statuses.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Celoscan (Celo Network Explorer) 18 Tools
These tools let you pull deep blockchain data: balance checks, transaction logs, token transfers, and source code retrieval for the Celo network.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Celoscan (Celo Network Explorer) on Vinkius019e5d05get account balance
Gets the CELO balance for a single address.
019e5d05get account balance multi
Gets the CELO balance for several addresses at once.
019e5d05get block countdown
Estimates how long until the next block is mined, based on a specific block number.
019e5d05get block number by time
Determines which blockchain block was active at a given timestamp.
019e5d05get block reward
Retrieves the reward amount for mining a specific block number.
019e5d05get contract abi
Pulls the Application Binary Interface (ABI) definition for verified smart contracts.
019e5d05get contract source code
Retrieves the original source code used to deploy a verified smart contract.
019e5d05get erc20 token balance
Checks the account balance for a specific ERC20 token type and contract.
019e5d05get erc20 token supply
Calculates the total circulating supply of an ERC20 token across the network.
019e5d05get erc20 transfers
Lists all recent transfer events for a specific ERC20 token type and address.
019e5d05get erc721 transfers
Provides a list of unique NFT (ERC721) transfers associated with an address.
019e5d05get internal transactions
Lists transactions that occurred inside a smart contract, showing deep execution paths.
019e5d05get last celo price
Retrieves the most recent market price for CELO.
019e5d05get mined blocks
Lists all blocks that were mined by a specific address.
019e5d05get normal transactions
Lists standard transactions initiated directly to and from an address.
019e5d05get total celo supply
Calculates the total available supply of CELO on the network.
019e5d05get transaction execution status
Checks if a smart contract executed its intended logic successfully or failed.
019e5d05get transaction receipt status
Verifies the final confirmation status of a submitted transaction hash.
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 Celoscan (Celo Network Explorer), then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Celoscan. 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 18 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking Assets Across Block Explorers Is a Nightmare
Today, figuring out where an asset went means opening multiple tabs: one for the main transaction list, another to check NFT transfers, and maybe a third just for the token's total supply. You copy addresses here, paste them there, scroll through dozens of entries, and then manually try to piece together if the funds arrived correctly.
With this MCP, you ask your agent one question—like 'Show me all asset movements for address X.' The system aggregates the data from multiple sources into one structured output. You get a complete history without ever leaving your chat window.
Get Contract ABI and Source Code
Before, developers had to navigate through complex contract addresses and find the corresponding documentation pages just to read what functions were even available. It was a manual lookup that often led to outdated or incomplete information.
Now you can pull the full ABI definition or the original source code directly into your workflow. You get immediate technical context attached right next to the transaction data.
What you can do with this MCP connector
Need to verify what happened with an asset on the Celo blockchain? This MCP connects your AI client directly to Celoscan's API, letting you audit complex financial movements without leaving your workflow. Instead of opening multiple explorer tabs or writing complex GraphQL queries, you ask your agent a question about an address or contract, and it gets the raw data back.
You can pull current CELO balances for single addresses or check token supplies across entire contracts. Even better, you can map out exactly how a token moved, tracking normal transfers alongside internal calls to see every step of the journey. Because this MCP runs on Vinkius, all your credentials pass through a zero-trust proxy; your keys never sit on disk.
This means you get full, verifiable chain data without risking sensitive access points.
019e5d06-1ea3-7307-9995-060b5c4156e9 
How Celoscan MCP Works
- 1 Enter your Celoscan API Key into the Vinkius platform.
- 2 Tell your AI agent which addresses and what kind of data you need (e.g., 'What was the total supply?').
- 3 Your agent runs the query, receiving structured, verifiable blockchain data back in plain text.
The bottom line is: You get deep on-chain financial forensic reporting without touching a dashboard.
Who Is Celoscan MCP For?
Web3 developers and crypto analysts who spend too much time clicking between block explorers, documentation sites, and spreadsheet tools. These are people who need to know exactly how an asset moved from Point A to Point B.
Uses the MCP to export detailed transaction histories and token movements for reporting or forensic accounting.
Pulls contract ABIs and source code directly into their IDE environment to validate protocol implementations before testing.
Monitors multiple wallet balances and transaction statuses from one chat window, providing real-time oversight of holdings.
What Changes When You Connect
- Know exactly where the money went. Use get_erc20_transfers or get_erc721_transfers to track every token (ERC20) or NFT (ERC721) transfer event associated with an address.
- See what happens behind the scenes. Running get_internal_transactions reveals actions that aren't obvious from a simple transaction list, showing deep contract execution paths.
- Get a full picture of holdings. You can check balances for multiple addresses at once using get_account_balance_multi, saving time when monitoring a portfolio.
- Validate the code itself. Pulling the ABI or source code via get_contract_abi lets developers test protocols without guessing what functions exist.
- Verify transaction completion. Use get_transaction_receipt_status to confirm if a submitted action actually succeeded on the chain, minimizing risk assessment errors.
Real-World Use Cases
Investigating an NFT sale
An analyst needs to know who owns the asset and where it went. They prompt their agent: 'List all ERC721 transfers for address X.' The system returns a chronological list, confirming the transfer path from the original minter to the current holder.
Tracking token liquidity
A product manager needs to know the total amount of a specific governance token. They ask the agent for the get_erc20_token_supply, getting an immediate number that dictates potential market cap calculations.
Debugging contract calls
A developer suspects a contract function failed. They use get_transaction_execution_status on the specific transaction hash to see if the failure was due to bad input or internal logic error.
Determining current asset value
Before making an investment decision, a user needs the current market rate. They prompt for get_last_celo_price and combine that data with their account balance from get_account_balance to calculate real-time risk exposure.
The Tradeoffs
Checking balances only
Seeing a high CELO balance from get_account_balance and assuming the funds are liquid or easily usable.
→ Don't stop there. Cross-reference that balance by also calling get_normal_transactions to see if recent outgoing transfers have reduced the available amount, confirming true liquidity.
Ignoring internal calls
Viewing only simple transactions and missing complex logic paths inside a smart contract.
→ Always run get_internal_transactions. This shows the deep flow of data that standard transaction logs skip, giving you a full view of the asset's journey.
Using only token type names
Asking for 'ERC20 transfers' without specifying which contract address or token to track.
→ You must narrow it down. Specify both the ERC20 token contract address and the target addresses when calling get_erc20_transfers.
When It Fits, When It Doesn't
Use this MCP if your job requires verifiable, granular proof of asset movement or code state. You need to map a full financial lifecycle: initial balance (get_account_balance), all transitions (get_internal_transactions and get_erc20_transfers), and final validation (get_transaction_receipt_status). Don't use this if you just need general market news; for that, check standard news APIs. If your only goal is to see the current token supply without needing transfer history, then get_total_celo_supply is enough. However, most real-world financial risk assessment requires combining these tools.
Common Questions About Celoscan MCP
Can I check the CELO balance of multiple addresses in a single request? +
Yes! Use the get_account_balance_multi tool and provide a comma-separated list of Celo addresses to retrieve all balances at once.
How can I view the source code of a verified smart contract on Celo? +
You can use the get_contract_source_code tool with the contract's address. If the contract is verified on Celoscan, the agent will return the full source code.
Is it possible to check if a specific transaction was successful? +
Yes, the get_transaction_receipt_status tool allows you to check the status of a transaction receipt to confirm if it was processed successfully on the network.
How do I use `get_internal_transactions` to find hidden contract movements? +
It provides a list of internal transactions, which are calls made by smart contracts rather than direct user transfers. This is critical for tracing complex actions like token swapping or governance votes within the Celo ecosystem.
What does `get_erc721_transfers` track specifically? +
The tool tracks specific transfer events for ERC721 tokens, commonly known as NFTs. This lets you audit the movement history of unique digital assets across the Celo blockchain, separate from standard token transfers.
Does `get_contract_abi` provide function definitions? +
Yes, it retrieves the Application Binary Interface (ABI) for a verified smart contract. This defines all the functions and methods available on that contract, letting your agent know exactly how to interact with it.
Can I use `get_block_countdown` to estimate network performance? +
This function gives you an estimated time until the next block is mined. Checking this helps monitor network latency and predict when transaction confirmations will become available, which is useful for rate-limited workflows.
How do I use `get_total_celo_supply` to check overall token economics? +
It returns the current total supply of CELO on the network. This metric is essential for macro-level analysis and reporting, giving you a clear picture of all tokens that have ever been minted.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.