• SUCCESS
  • FAILURE
  • BUNDLE
  • HUMAN

How to simulate ethereum transactions with your AI

Connect Tenderly to your AI client to test smart contract logic in a sandbox. You'll catch errors before they hit the mainnet.

Ask AI about this page

Short answer

How can I use AI to simulate Ethereum transactions?

Your AI uses Tenderly to run single transactions or complex bundles against a virtual state. This lets you see exactly how a contract behaves without paying any gas fees. You get a clear view of state changes and execution results.

The simulation outcomes

Where your results land.

Every request to the Tenderly MCP results in one of these scenarios.

SUCCESS

Verified state changes

The AI confirms the transaction succeeded. You get a clear view of how the contract state changed after execution.

FAILURE

Error identification

The AI catches reverts or failed logic. It identifies exactly where the transaction failed so you can fix the code.

BUNDLE

Multi-step verification

The AI runs a sequence of transactions together. This shows how multiple calls interact within a single block.

HUMAN

Manual code fixes

The AI identifies the bug, but you must go into your IDE to rewrite the smart contract logic.

The workflow

What your AI does when a simulation request arrives.

The AI handles the heavy lifting of interacting with the Tenderly API.

  1. Analyze the request

    Your AI parses your natural language instructions to extract the target contract address, function name, and arguments.

    simulate_transaction

  2. Run single tests

    The AI executes a single call to check if a specific function works as intended.

    simulate_transaction

  3. Execute transaction bundles

    The AI groups multiple calls into a single sequence to test complex interactions.

    simulate_bundle

  4. Report results

    The AI interprets the trace data and tells you if the transaction succeeded or reverted.

    simulate_transactionsimulate_bundle

Try it

Copy these to start.

Use these prompts to kick off your first simulation.

Starting points

Swap the bracketed text with your actual contract addresses and function parameters.

Tenderly Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_N4CrFBeUVzbat4muj6uWeqLKjZIfSS9VAScUfQGd/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Tenderly capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "tenderly-ethereum-dev-platform-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_N4CrFBeUVzbat4muj6uWeqLKjZIfSS9VAScUfQGd/mcp"
    }
  }
}
Copy into chat04

  • Simulate a transaction for contract 0x123... calling the deposit function with 1 ETH.

  • Run a transaction bundle to swap tokens on this contract and then check the balance.

  • Check why this specific transaction call is reverting using simulate_transaction.

  • Simulate a bundle of three consecutive calls to the vault contract to verify state updates.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Tenderly once, then ask.

Just link your Tenderly account to the Vinkius platform. Your credentials stay encrypted, and you can immediately start prompting your AI to run simulations.

Connect Tenderly to your AI

FAQ

How this task behaves.

  • 01

    Does simulating transactions cost gas?

    No. Simulations happen in a virtual environment, so you don't spend any real ETH.

  • 02

    Can the AI deploy new contracts?

    No. The AI can only simulate existing contract logic using the available simulation tools.

  • 03

    Can I simulate a bundle of transactions?

    Yes, you can use the bundle tool to test multiple calls in a single sequence.

  • 04

    Will the AI execute these on the live mainnet?

    No. The AI only runs simulations. It cannot send real transactions to the blockchain.

  • 05

    Can the AI fix my smart contract code automatically?

    No. The AI can tell you why a transaction failed, but you have to write and deploy the actual code fixes yourself.

  • More questions about Tenderly? The Connector page answers them. See everything the Tenderly Connector can do

Connect Tenderly to Claude, Cursor, ChatGPT & more