# Celoscan MCP for AI Agents AI Agent Connect > Celoscan lets you pull real-time data from the Celo blockchain directly into your AI agent. You can check wallet balances, track token transfers, and inspect smart contract source code without ever switching tabs. It handles CELO, ERC20, and ERC721 data so you can audit on-chain activity through simple chat commands. Whether you're debugging a protocol or tracking a whale's movements, this Connector puts Celo network data at your fingertips. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Bi2Drf8yY8oexFIUWvJ1Ab8dwC6NJP1TE52TOfPz/ai-agent-connect - **Tags:** celo, block-explorer, smart-contracts, crypto-wallet, web3 ## Description Celoscan connects your AI agent to the Celo blockchain so you can query on-chain data using plain English. Instead of jumping between browser tabs and manually digging through explorer pages, you can just ask your agent to pull the information you need. This is a huge shift for anyone who spends their day auditing smart contracts or tracking token movements. You can pull verified source code, fetch contract ABIs, and check transaction statuses without ever leaving your chat interface. It handles the heavy lifting of fetching CELO balances, ERC20 token supplies, and internal transaction histories. When you use this via the Vinkius marketplace, you get a unified way to monitor wallet holdings and audit on-chain activity in one place. It turns your chat window into a live dashboard for Celo network activity, making it much easier to debug protocols or verify token movements. You don't have to remember specific API endpoints or mess with complex queries; you just tell your agent what you're looking for and it pulls the latest data from Celoscan. Whether you're looking for a specific block reward or the last price of CELO, the data comes to you. It removes the friction of manual data entry and gives you a direct line to the blockchain. ## Tools ### get_account_balance Get the CELO balance for a single wallet address. Use this to check current holdings quickly. ### get_account_balance_multi Get CELO balances for multiple addresses at once. Use this to monitor several wallets in one go. ### get_block_countdown Get the estimated time until the next block is mined. Useful for monitoring network speed. ### get_block_reward Get the block rewards for a specific block number. Use this to analyze network incentives. ### get_contract_abi Get the ABI for a verified smart contract. Use this to understand a contract's available functions. ### get_contract_source_code Get the source code for a verified smart contract. Use this for deep technical auditing. ### get_erc20_token_balance Get the ERC20 token balance for a specific account. Use this to check specific token holdings. ### get_erc20_token_supply Get the total supply of an ERC20 token. Use this to audit tokenomics for a specific contract. ### get_erc20_transfers Get a list of ERC20 token transfer events for an address. Use this to track specific token movements. ### get_erc721_transfers Get a list of ERC721 token transfer events for an address. Use this to track NFT movements. ### get_internal_transactions Get a list of internal transactions for an address. This helps track complex contract interactions. ### get_mined_blocks Get a list of blocks mined by a specific address. This helps verify mining activity. ### get_normal_transactions Get a list of standard transactions for an address. Use this to see basic wallet activity. ### get_total_celo_supply Get the total supply of CELO on the network. Use this to verify the total circulating amount. ### get_transaction_execution_status Check the execution status of a smart contract. This helps identify why a transaction failed. ### get_transaction_receipt_status Check the receipt status of a transaction. Use this to confirm if a transfer was successful. ### get_block_number_by_time Get the block number for a specific timestamp. Use this to find historical data points. ### get_last_celo_price Get the most recent price of CELO. Use this for quick market context during your research. ## Prompt Examples **Prompt:** ``` What's the current price of CELO and the total supply? ``` **Response:** ``` Here is the current data for CELO on the Celo Network: * **Current Price:** $0.42 * **Total Supply:** 1,245,000,000 CELO Let me know if you need the balance for a specific wallet as well. ``` **Prompt:** ``` Can you show me the last 5 ERC20 transfers for 0x1234567890abcdef1234567890abcdef12345678? ``` **Response:** ``` I found the recent ERC20 transfers for that address: | Token | Amount | From | To | | :--- | :--- | :--- | :--- | | cUSD | 500.00 | 0x789... | 0xabc... | | cUSD | 150.00 | 0x123... | 0x456... | | ... | ... | ... | ... | Would you like me to check the balance for any of these tokens? ``` **Prompt:** ``` Get the source code for the contract at 0x456... and tell me what it does. ``` **Response:** ``` I've retrieved the source code for the contract at `0x456...`. It appears to be a standard ERC20 token implementation with a custom `mint` function. It includes standard functions like `transfer`, `approve`, and `balanceOf`. Do you want me to pull the ABI so you can see the specific function signatures? ``` ## Capabilities ### Check CELO balances Get the current CELO balance for any specific wallet address. ### Track ERC20 token movements Pull a history of ERC20 token transfers for a given address. ### Inspect smart contract source code Retrieve the verified source code for smart contracts on Celo. ### View internal transaction history See the list of internal transactions associated with a specific address. ### Monitor block rewards Check the rewards issued for specific block numbers on the network. ### Fetch contract ABIs Get the ABI for verified smart contracts to understand their functions. ### Verify transaction receipts Check the status of a transaction to see if it was successfully received. ## Use Cases ### Debugging a failed contract A developer asks their agent to check the execution status of a failed transaction using get_transaction_execution_status to find the error. ### Auditing a new token launch An analyst pulls the total supply and recent transfers for a new ERC20 token using get_erc20_token_supply and get_erc20_transfers. ### Tracking NFT movements A user wants to see who just bought a specific NFT and asks the agent to list the latest ERC721 transfers for a wallet. ### On-chain forensics research A researcher tracks a whale's activity by pulling both normal and internal transactions for a specific address in one chat. ## Benefits - Skip the explorer tabs by using get_contract_source_code to pull verified code directly into your chat for debugging. - Monitor multiple wallets in one request using get_account_balance_multi to keep a better overview of holdings. - Audit token flows quickly with get_erc20_transfers and get_erc721_transfers to see every move an address makes. - Verify smart contract functions instantly with get_contract_abi without having to leave your workspace. - Get instant market context by pulling the last CELO price and total supply with get_last_celo_price and get_total_celo_supply. - Track transaction success with get_transaction_receipt_status to avoid manual checking of block explorers. ## How It Works The bottom line is you get real-time Celo blockchain data in your chat window without leaving your workspace. 1. Subscribe to the Celoscan MCP on Vinkius. 2. Enter your Celoscan API key in the configuration settings. 3. Ask your AI client to pull Celo network data or check a specific wallet balance. ## Frequently Asked Questions **What is the Celoscan MCP?** It is a way to connect your AI agent directly to the Celo blockchain. It lets you ask questions about balances, transactions, and smart contracts using plain English. **Can I check my wallet balance with the Celoscan MCP?** Yes. You can ask your agent to check the CELO balance for any specific wallet address, or even check balances for multiple addresses at once. **Does the Celoscan MCP work for NFTs?** Yes, it can track ERC721 transfer events, which means you can ask your agent to show you recent NFT movements for a specific wallet. **How do I get contract source code using this Connector?** You just ask your agent to pull the source code for a verified smart contract. It will fetch the verified code from the blockchain and display it in your chat. **Can I see internal transactions with Celoscan?** Yes. The Connector can pull internal transaction history, which is useful for seeing complex interactions between different smart contracts. **Is the Celoscan MCP for the Celo network only?** Yes, this specific MCP is designed to interact with the Celo blockchain and its unique data points. **Can I track multiple wallets at once?** Yes, you can use the multi-balance tool to get the CELO holdings for several different addresses in a single request. **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.