# Tenderly MCP for AI Agents AI Agent Connect > Tenderly (Ethereum Dev Platform) MCP lets you simulate Ethereum transactions, manage Virtual TestNets, and set up on-chain alerts through your AI agent. It is built for developers who need to test smart contracts and DeFi protocols without spending real gas or risking assets on the mainnet. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_N4CrFBeUVzbat4muj6uWeqLKjZIfSS9VAScUfQGd/ai-agent-connect - **Tags:** smart-contracts, ethereum, transaction-simulation, web3-debugging, testnet, blockchain-monitoring ## Description You can use this Connector to move your Ethereum development into a more interactive space where your agent actually understands the blockchain state. Instead of manually checking logs or guessing how a complex multi-step swap will behave, you can ask your agent to run those scenarios for you. You can spin up private replicas of the mainnet to see exactly how your dApp handles specific conditions, or set up automated watchers for your production contracts. This connects your development environment to the Tenderly platform, making it a core part of your workflow. Because it is hosted on the Vinkius marketplace, you can plug it into your existing AI setup and start debugging smart contracts with natural language commands. It handles the heavy lifting of transaction bundling and simulation so you can focus on the logic of your code rather than the mechanics of the network. ## Tools ### create_alert Set up notifications for specific method calls, state changes, or balance updates. It helps you stay informed about on-chain activity in real time. ### create_virtual_testnet Generate a private mainnet replica with custom configurations for your dApp. This lets you test in a production-like environment. ### simulate_bundle Run a sequence of transactions together to see how they interact with each other. This is perfect for debugging complex DeFi protocols. ### simulate_transaction Predict the outcome and gas cost of a single transaction on any supported network. Use this to verify contract behavior before deployment. ## Prompt Examples **Prompt:** ``` Simulate a transaction on Ethereum Mainnet from 0xd8dA... to 0x7a25... with data 0x095ea7b3... ``` **Response:** ``` I've simulated the transaction for you. Here are the results: * **Status**: Success * **Gas Consumed**: 45,000 * **Result**: Triggered an ERC20 Approval event for the Uniswap V2 Router. Would you like me to show you the full state changes for this transaction? ``` **Prompt:** ``` Create a Virtual TestNet named 'Staging-Fork' forked from Mainnet at the latest block. ``` **Response:** ``` I have successfully created the Virtual TestNet for you. * **Name**: Staging-Fork * **Source**: Mainnet (latest block) * **RPC URL**: [Generated URL] * **Chain ID**: [Your Virtual ID] You can now use this private fork to test your dApp interactions. ``` **Prompt:** ``` Set up an alert to notify me whenever the 'transfer' method is called on contract 0x123... ``` **Response:** ``` I've set up that alert for you. * **Contract**: 0x123... * **Method**: transfer * **Action**: Notify on every call You will receive a notification based on your project settings whenever this event is detected on-chain. ``` ## Capabilities ### Simulate complex transaction bundles Run a sequence of multiple transactions to see how they interact with each other. ### Create private mainnet replicas Generate a Virtual TestNet to test your dApp in a production-like environment. ### Set up real-time on-chain alerts Create notifications for specific method calls, state changes, or value transfers. ### Predict gas costs and state changes Get a preview of the results and fees of a transaction before you commit to it. ### Monitor specific contract methods Track when specific functions are called on your production or test contracts. ## Use Cases ### Debugging a complex swap A developer wants to see if a three-step trade fails. They ask their agent to simulate a bundle to see the exact state changes. ### Mainnet testing without risk A developer needs to test a new contract on the real mainnet without spending money. They use the agent to create a Virtual TestNet. ### Production monitoring A DevOps lead wants to know every time a specific withdraw function is called. They use the agent to create an alert for that method. ### Gas estimation A researcher wants to know the cost of an ERC20 transfer. They simulate the transaction to get the exact gas and result. ## Benefits - Run complex DeFi simulations using simulate_bundle to see how multi-step swaps interact before you deploy any code. - Save on gas costs by using simulate_transaction to check for errors and gas requirements on the mainnet before committing. - Build safer dApps by creating private replicas with create_virtual_testnet to mimic production environments with custom settings. - Get instant updates on contract activity by setting up specific method call or state change alerts with create_alert. - Debug smart contracts faster by asking your agent to interpret the results of simulated transaction bundles and state changes. ## How It Works The bottom line is you get a sandbox to test blockchain interactions without the risk of real-world errors. 1. Subscribe to the Connector and provide your Tenderly Access Key, Account Slug, and Project Slug. 2. Connect the Connector to your preferred client like Claude, Cursor, or Windsurf. 3. Use natural language to simulate transactions, create testnets, or set up alerts. ## Frequently Asked Questions **Can I use the Tenderly MCP to test my smart contracts?** Yes, you can use it to simulate transactions and bundles to see how your code behaves. It gives you a preview of the results and gas costs before you deploy. **Does the Tenderly MCP cost gas to use?** No, simulations happen off-chain. You can run as many simulations as you need without spending any real assets or gas. **How do I create a private test environment with Tenderly MCP?** You can use the Virtual TestNet tool to fork the mainnet. This creates a private replica where you can test your dApp in a production-like environment. **Can the Tenderly MCP monitor my production contracts?** Yes, it allows you to set up alerts for specific method calls, state changes, or balance updates on your live contracts so you stay informed. **Can I simulate multiple transactions at once?** Yes, you can use the bundle simulation tool. This is ideal for seeing how a sequence of actions, like a multi-step swap, interacts with the blockchain. **Is the Tenderly MCP good for DeFi research?** It is excellent for research. It lets you trace complex interactions and analyze protocol behavior without needing to risk real capital. **Can I simulate a transaction without spending real ETH or gas?** Yes! Use the `simulate_transaction` tool. It runs the transaction against the latest state of the network in a virtual environment, providing full trace and results without any on-chain cost. **How do I create a private fork of Ethereum for testing?** You can use the `create_virtual_testnet` tool. Provide a slug, display name, and the network ID you want to fork from (e.g., 1 for Mainnet) to spin up a private RPC endpoint. **Can I monitor specific smart contract events automatically?** Absolutely. Use the `create_alert` tool with an `alert_config` object to monitor method calls, state changes, or emitted logs on any contract address.