Celoscan MCP. Audit Celo network balances and contract code instantly.
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) gives you direct access to the Celo blockchain via your AI agent. Check CELO balances, track ERC20 and ERC721 transfers, and inspect smart contract code without leaving your chat.
You can query transaction history, get contract ABIs, and monitor network activity just by asking natural language questions.
What your AI agents can do
Get account balance
Gets the CELO balance for a single crypto address.
Get account balance multi
Gets the CELO balance for multiple crypto addresses at once.
Get block countdown
Calculates the estimated time remaining until the next block is mined by a given block number.
Checks the CELO balance for one or many specified crypto addresses.
Retrieves the Application Binary Interface (ABI) and source code for verified smart contracts.
Lists recent ERC20 or ERC721 token transfers associated with an address.
Retrieves all types of transactions—normal, internal, and specific token movements—for an address.
Gets the current estimated block countdown time or checks the status of a specific transaction receipt.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019e5d05get account balance
Gets the CELO balance for a single crypto address.
019e5d05get account balance multi
Gets the CELO balance for multiple crypto addresses at once.
019e5d05get block countdown
Calculates the estimated time remaining until the next block is mined by a given block number.
019e5d05get block number by time
Determines the specific block number that was mined at a given timestamp.
019e5d05get block reward
Retrieves the block reward value based on the block number.
019e5d05get contract abi
Gets the Application Binary Interface (ABI) for a verified smart contract.
019e5d05get contract source code
Retrieves the original source code for a verified smart contract.
019e5d05get erc20 token balance
Gets the balance of a specific ERC20 token for a given contract address.
019e5d05get erc20 token supply
Gets the total circulating supply for a specific ERC20 token contract.
019e5d05get erc20 transfers
Lists all recent ERC20 token transfer events for a specific address.
019e5d05get erc721 transfers
Lists all recent ERC721 NFT transfer events for a specific address.
019e5d05get internal transactions
Lists all internal transactions that occurred for a specific address.
019e5d05get last celo price
Retrieves the most recent trading price for CELO.
019e5d05get mined blocks
Lists all blocks that were mined by a specific address.
019e5d05get normal transactions
Lists all standard, direct transactions associated with an address.
019e5d05get total celo supply
Gets the total circulating supply of CELO on the network.
019e5d05get transaction execution status
Checks if a smart contract execution completed successfully.
019e5d05get transaction receipt status
Checks the final status of a transaction receipt on the blockchain.
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,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
You've got direct access to the Celo blockchain through your AI agent. This server lets you check addresses, audit smart contracts, and track every type of transaction just by talking to it. You'll know exactly what's going on with CELO and the tokens on the network.
Checking Balances
You can use get_account_balance to check the CELO balance for a single crypto address. Need to check a bunch of accounts? Use get_account_balance_multi to get the CELO balance for multiple crypto addresses at once. You'll also get the total circulating supply of CELO on the network using get_total_celo_supply.
Tracking Transfers and Tokens
To see what's moving, use get_erc20_transfers to list all recent ERC20 token transfer events for a specific address. For NFTs, get_erc721_transfers lists all recent ERC721 transfer events associated with an address. You can check the balance of a specific ERC20 token using get_erc20_token_balance and find out the total circulating supply for that token with get_erc20_token_supply.
You can also see all standard, direct transactions with get_normal_transactions, or dig into the stuff happening under the hood using get_internal_transactions to list all internal transactions for an address.
Auditing Contracts and Code
Want to see how a smart contract works? Use get_contract_abi to grab the Application Binary Interface (ABI) for a verified smart contract. You can also run get_contract_source_code to retrieve the original source code for that same verified smart contract. If you need to know if a contract call actually finished, get_transaction_execution_status checks the completion status of a smart contract execution, and get_transaction_receipt_status checks the final status of a transaction receipt on the blockchain.
Examining Transaction History and Network Status
You can track an address's history by using get_normal_transactions and get_internal_transactions. To see all blocks mined by a specific address, use get_mined_blocks. You can also find out the block number that was mined at a given time with get_block_number_by_time, or calculate the estimated time left until the next block using get_block_countdown.
For block rewards, get_block_reward retrieves the value based on a block number. You can also see the most recent trading price for CELO with get_last_celo_price.
How Celoscan MCP Works
- 1 Subscribe to the server and provide your Celoscan API Key.
- 2 Ask your AI agent a question about a blockchain event (e.g., 'What was the last transfer for address X?').
- 3 The agent executes the necessary tool calls, fetching the data and presenting the audit report to you.
The bottom line is, you can audit the Celo blockchain using your natural language agent without needing to write complex API calls.
Who Is Celoscan MCP For?
Anyone who needs to verify on-chain data, from financial analysts tracking token movements to developers debugging smart contracts. If your job involves looking at a wallet address or a smart contract, this server saves you time.
Pulls contract ABIs and source code directly into their IDE to understand how a protocol is implemented.
Exports transaction histories and token movements for reporting or on-chain forensic accounting.
Monitors transaction statuses and block mining activities to verify system health.
What Changes When You Connect
- Check balances for multiple addresses instantly. Use
get_account_balance_multito monitor a whole portfolio without running separate queries. - Audit smart contracts deeply.
get_contract_abiandget_contract_source_codelet you pull the exact code and function definitions needed for debugging. - Trace token flows precisely. You can separate standard transfers using
get_erc20_transfersand NFT movements viaget_erc721_transfers. - Verify transaction health. Use
get_transaction_receipt_statusto confirm if a transaction actually completed, not just if it was sent. - See the full picture of an account. Combine
get_normal_transactions,get_internal_transactions, andget_erc20_transfersto get a complete audit trail. - Understand the network mechanics. Use
get_last_celo_priceandget_total_celo_supplyto keep context on the overall market and network state.
Real-World Use Cases
Investigating a suspicious wallet.
A security analyst needs to know exactly what a wallet did. They ask the agent to list all transfers for address 0x... The agent runs get_erc20_transfers and get_internal_transactions to show every token movement and internal contract call, revealing the full activity timeline.
Debugging a DeFi interaction.
A developer finds an unexpected failure. They use the agent to run get_contract_abi and get_contract_source_code on the relevant contract. This gives them the contract logic, allowing them to debug why the transaction failed (e.g., checking get_transaction_execution_status).
Portfolio status check.
A user needs to know the total value of five different accounts. Instead of five separate calls, they ask for the balance, and the agent executes get_account_balance_multi, instantly returning all five CELO balances.
Tracking NFT ownership history.
A collector wants to prove ownership history for an NFT. They ask the agent to check the transfers for a specific token type, and the agent executes get_erc721_transfers, providing a clean list of every ownership change.
The Tradeoffs
Checking only the raw balance.
A user only asks, 'What is the balance of address X?'. This only runs get_account_balance and misses token movement details or contract logic.
→
To get a full picture, ask the agent to 'Show me all token movements and the contract ABI for address X.' The agent then runs get_account_balance, get_erc20_transfers, and get_contract_abi for a complete view.
Ignoring transaction status.
Assuming a transaction sent is successful just because it was broadcast. This overlooks failures like contract execution errors.
→
Always check the outcome. Ask the agent to use get_transaction_receipt_status and get_transaction_execution_status to confirm the transaction finalized correctly.
Manually cross-referencing data.
Copying the address from a block explorer, then manually switching to a different tool to check the contract code. This is slow and error-prone.
→
Give the agent the address and ask for a full audit: 'Audit this contract at address Y.' The agent runs get_contract_abi, get_contract_source_code, and get_erc20_transfers sequentially for a single, unified report.
When It Fits, When It Doesn't
Use this server if you need to treat blockchain data as a queryable resource. Specifically, if you need to correlate state (using get_account_balance) with history (using get_erc20_transfers) or logic (using get_contract_abi).
Don't use this if you just need general crypto news or price predictions. For simple price checks, get_last_celo_price is enough. If you are only interested in block timings, get_block_number_by_time works. But if you need to know why the balance changed, you need the full suite of tools.
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.
Available Capabilities
Manually tracking token movements across multiple tabs is a nightmare.
Right now, tracking a token's life cycle means jumping between the main block explorer, the token contract page, the address history tab, and the internal transaction ledger. You copy addresses, you switch tabs, you filter dates, and you manually piece together the story of who owned what and when.
With this MCP server, you just tell your agent: 'Show me all activity for this address.' It runs all the necessary checks—token transfers, internal calls, and normal transactions—and gives you one consolidated report. It's the full audit trail, delivered in plain English.
Celoscan MCP Server: Audit Celo network balances and contract code instantly.
You no longer need to guess if a transaction succeeded. Instead of checking the main block explorer and hoping the status matches, you ask your agent to use `get_transaction_receipt_status`. It tells you the final outcome, period.
It's direct. Your agent hits the API, gets the verified status, and tells you if the contract finished correctly or if the transaction failed—no guesswork involved.
Common Questions About Celoscan MCP
How do I check the CELO balance using the get_account_balance tool? +
You provide the wallet address, and the tool returns the current CELO balance. If you have multiple addresses, use get_account_balance_multi to get them all in one call.
What is the difference between get_normal_transactions and get_internal_transactions? +
Normal transactions are the direct user actions. Internal transactions are automated calls triggered by a contract, which are crucial for understanding complex DeFi flows.
Can I get the source code for a smart contract using get_contract_source_code? +
Yes. This tool fetches the original source code, which is key for developers who need to understand the contract's underlying logic for debugging or auditing.
What if I need to know the total supply of a token? Should I use get_erc20_token_supply? +
Yes, get_erc20_token_supply gets the total circulating supply for a specific token contract address. This is separate from checking an individual account's balance.
How do I list all transfers for both ERC20 and ERC721 tokens using get_erc20_transfers and get_erc721_transfers? +
You call both tools sequentially. Use get_erc20_transfers for fungible tokens and get_erc721_transfers for non-fungible assets. This separation keeps the data clean and makes it easy to report on different asset types.
What if I need to check the status of a transaction after I run get_transaction_receipt_status? +
The tool confirms if the transaction was successful, failed, or is still pending. If it shows failure, you'll need to check the execution status using get_transaction_execution_status to pinpoint the exact error.
Can I calculate the total CELO supply or just get the total supply using get_total_celo_supply and get_erc20_token_supply? +
Use get_total_celo_supply for the main CELO token supply. The get_erc20_token_supply tool is specific; it calculates the total supply for any given ERC20 contract address.
What parameters are needed to use get_account_balance_multi? +
You must provide a list of addresses. The tool accepts a list of multiple addresses, allowing you to fetch CELO balances for several wallets in a single query.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Socket.dev (Dependency Security)
Protect your software supply chain by scanning dependencies, checking package security scores, and monitoring threat feeds directly from your AI agent.
Kuaishou Mini-Game
Kuaishou mini-game developer API — manage cloud storage, leaderboards, analytics, and content moderation for casual games.
GetBlock (Web3 RPC Provider)
Access 50+ blockchain networks (Ethereum, Solana, Bitcoin) via RPC. Query balances, blocks, and transactions directly from your AI agent.
You might also like
Yida
Enterprise low-code development platform by DingTalk — manage forms, data instances, and approval workflows via AI.
Memo Meister
Create and organize smart notes with AI-powered tagging, search, and knowledge connections that make your ideas retrievable.
Freightview
Automate LTL freight quoting, track shipments, and manage carriers via AI agents with Freightview.