# Nodereal MCP for AI Agents AI Agent Connect > Nodereal provides high-performance blockchain infrastructure for Aptos and EVM networks. It lets your AI agent query account balances, inspect block data, and simulate transactions across multiple chains instantly. Whether you're debugging smart contracts or pulling on-chain logs, this Connector gives your agent direct access to reliable RPC endpoints for real-time blockchain data. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_rBCCylJboTjAuEJjKxGS91gr4oIB05T0frrua8Di/ai-agent-connect - **Tags:** aptos, ethereum, evm, rpc, web3, infrastructure ## Description Connecting your agent to the blockchain shouldn't feel like a chore. If you're trying to figure out why a smart contract failed or if you need to pull a list of NFT holders across different chains, you usually end up jumping between multiple dashboards and manually copying data. This Connector changes that by giving your agent a direct line to NodeReal's high-performance infrastructure. Instead of hunting for information, you can just ask your agent to check an account's balance, pull transaction receipts, or see what's happening on the Aptos ledger right now. It handles the heavy lifting of talking to the RPC endpoints so you can stay focused on the actual work. You'll find it's a lot faster to get answers when your agent can actually see the state of the network. It's one of the reasons the Vinkius catalog is so valuable for developers who need to move quickly without building their own infrastructure. You get real-time data for both EVM-compatible chains and the Aptos ecosystem in one place, making it much easier to debug, monitor, and analyze on-chain activity as it happens. You can stop worrying about node maintenance or RPC rate limits and start focusing on the logic of your dApps. Whether you're building a new DeFi protocol or just doing some deep research into whale movements, having this level of access directly in your chat interface makes a massive difference in your daily velocity. ## Tools ### eth_get_logs Filter and retrieve logs from EVM smart contracts. It's the go-to tool for complex on-chain data analysis. ### eth_get_transaction_receipt Get the final receipt for an EVM transaction. Use this to confirm if a transaction succeeded or failed. ### eth_send_raw_transaction Create a new message call or contract creation for signed transactions. This is for sending raw data to the EVM. ### nr_get_asset_transfers Get asset transfers for a specific address using NodeReal's enhanced data. It provides a deeper look at movement on the chain. ### nr_get_nft_holders Retrieve a list of holders for a specific NFT collection. This is great for analyzing ownership distribution. ### nr_get_nft_inventory See the entire NFT inventory for a specific address. Use this to see what a user currently owns. ### nr_get_token_balance_20 Get the ERC20 token balance for an address. This is a specialized tool for checking specific token holdings. ### nr_get_token_holders Pull a list of holders for a specific token. It helps with identifying the largest stakeholders in a project. ### nr_get_transaction_receipts_by_block_number Get all receipts within a specific block. This is useful for bulk auditing of block activity. ### aptos_get_transaction_by_hash Get specific Aptos transaction details using its unique hash. It's perfect for looking up the history of a specific on-chain action. ### aptos_get_account_modules List all Move modules for a specific Aptos account. This helps you see what's running on a specific address. ### aptos_get_account_resources Get all resources for an Aptos account. Use this to inspect the state of an account's assets. ### aptos_get_account Get high-level information about an Aptos account. It's the first thing you should check when investigating an address. ### aptos_get_blocks_by_height Get Aptos blocks at a specific height. This lets you look back at historical chain data. ### aptos_get_ledger_info Get the current ledger information for the Aptos network. This gives you a snapshot of the current chain state. ### aptos_get_transactions Pull a list of recent Aptos transactions. Use this to see the latest activity on the network. ### aptos_simulate_transaction Run a simulation on an Aptos transaction before you send it. This helps you check for errors and see the gas cost upfront. ### debug_trace_transaction Trace an EVM transaction to see its execution path. It helps you understand exactly what happened during a smart contract call. ### eth_block_number Get the current block number for an EVM chain. This is the quickest way to check the latest network height. ### eth_call Execute a message call on an EVM chain without sending a transaction. It's the standard way to interact with smart contracts instantly. ### eth_chain_id Retrieve the unique chain ID for an EVM network. This ensures your agent is looking at the correct blockchain. ### eth_estimate_gas Calculate the gas needed for an EVM transaction. Use this to prevent out-of-gas errors before you commit. ### eth_get_balance Check the balance of any address on an EVM chain. It returns the amount in wei for easy calculation. ### eth_get_block_by_number Fetch all data for a specific block on an EVM chain. This is useful for inspecting historical block data. ## Prompt Examples **Prompt:** ``` What's the current balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on the Ethereum network? ``` **Response:** ``` I've checked the balance for that address on the Ethereum network. | Metric | Value | | :--- | :--- | | **Balance (ETH)** | 1.25 ETH | | **Balance (Wei)** | 1,250,000,000,000,000,000 | Let me know if you need me to check any other addresses or pull the transaction history for this one. ``` **Prompt:** ``` Can you check if the transaction 0x123... failed and tell me why? ``` **Response:** ``` I've analyzed the transaction receipt and the debug trace. **Status:** Failed **Reason:** Out of Gas **Details:** * **Gas Used:** 210,000 * **Gas Limit:** 200,000 * **Execution Error:** The transaction hit the limit before completion. Would you like me to estimate the gas for a new attempt? ``` **Prompt:** ``` Who owns the most NFTs in this specific collection? ``` **Response:** ``` I've pulled the holder list for the collection. Here are the top 3 owners: 1. **0xAb12...** - 450 NFTs 2. **0xCd34...** - 320 NFTs 3. **0xEf56...** - 285 NFTs I can pull the full inventory for any of these addresses if you'd like to see more details. ``` ## Capabilities ### Query account balances Get the current balance of any address on EVM-compatible chains instantly. ### Simulate Aptos transactions Run a mock transaction on Aptos to see the gas cost and execution result before committing. ### Fetch EVM transaction logs Pull filtered logs from smart contracts for deep on-chain data analysis. ### Get NFT inventory data Retrieve a full list of NFTs owned by a specific wallet address. ### Trace EVM transactions See the step-by-step execution path of an EVM transaction to debug failures. ### Retrieve Aptos account resources Inspect the resources and Move modules associated with an Aptos account. ## Use Cases ### Debugging a failed smart contract A dev asks why a transaction failed. The agent uses debug_trace_transaction and eth_get_transaction_receipt to pinpoint the exact block and step where the logic broke. ### Auditing NFT distributions A researcher wants to know who owns a specific collection. The agent uses nr_get_nft_holders to pull the full list and summarize the top holders. ### Pre-flight transaction checks A user wants to send a large transfer. The agent uses aptos_simulate_transaction to confirm the gas cost and ensure the execution logic won't fail. ### Monitoring Aptos account activity A dev needs to see what modules an address is running. The agent uses aptos_get_account_modules to list them instantly. ## Benefits - Check balances and transaction history across multiple chains without switching tabs using eth_get_balance and aptos_get_account. - Predict transaction costs and success before committing to the network with aptos_simulate_transaction and eth_estimate_gas. - Analyze complex smart contract interactions by pulling logs and trace data with eth_get_logs and debug_trace_transaction. - Inspect NFT ownership and token distributions quickly using NodeReal's enhanced tools like nr_get_nft_holders. - Monitor Aptos ledger state and account resources in real-time with aptos_get_ledger_info and aptos_get_account_resources. ## How It Works The bottom line is you get direct, reliable blockchain data for Aptos and EVM chains without managing your own RPC nodes. 1. Subscribe to the Nodereal MCP on Vinkius. 2. Paste your NodeReal API Endpoint URL into your AI client's configuration. 3. Ask your agent to pull blockchain data, check balances, or simulate transactions. ## Frequently Asked Questions **Can Nodereal MCP help me check balances on multiple chains?** Yes, it allows your agent to query balances on both Aptos and EVM-compatible networks. You can ask for specific address balances and get the results instantly. **How does Nodereal MCP work with Aptos?** It connects your agent to Aptos RPC endpoints. This means you can retrieve account resources, Move modules, and ledger info using plain language. **Can I use Nodereal MCP to simulate transactions?** Yes, you can use the simulation tools to see how a transaction will behave on Aptos before you actually send it. This helps you avoid failed transactions and save on gas. **Is Nodereal MCP good for NFT research?** It's excellent for that. You can use it to pull NFT inventories for specific addresses or get a full list of holders for an entire collection. **Does Nodereal MCP support Ethereum logs?** Yes, it includes tools to fetch and filter logs from EVM smart contracts, which is essential for deep on-chain data analysis. **How do I connect Nodereal MCP to my AI client?** You just need your NodeReal API Endpoint URL. Once you add that to your Connector client, your agent can start querying the blockchain immediately. **Can I check the resources associated with an Aptos account?** Yes, you can use the `aptos_get_account_resources` tool by providing the account address to see all Move resources stored on that account. **How do I retrieve logs for a specific smart contract on an EVM chain?** Use the `eth_get_logs` tool. You will need to provide a JSON filter object containing parameters like the contract address and block range. **Is it possible to test an Aptos transaction without actually sending it?** Absolutely. The `aptos_simulate_transaction` tool allows you to submit a transaction payload to see if it would succeed and how much gas it would consume.