What is Transactionsimulatormcp

TransactionSimulatorMCP is an MCP service that provides AI-powered analysis of Ethereum transactions across any network, allowing users to simulate transactions and understand potential outcomes before execution.

Use cases

Use cases include simulating ERC20, ERC721, and ERC1155 token transfers, analyzing contract interactions, estimating gas costs, and providing insights into potential transaction impacts before execution.

How to use

To use TransactionSimulatorMCP, clone the repository, install dependencies, configure environment variables, and run the server in either development or production mode using npm commands.

Key features

Key features include real-time transaction simulation, AI-powered interpretation, support for all Ethereum-compatible networks, detailed analysis of token transfers and contract interactions, gas estimations, secure HTTPS support, and real-time updates via Server-Sent Events.

Where to use

TransactionSimulatorMCP can be used in various fields such as blockchain development, financial analysis, and decentralized application (dApp) testing, where understanding transaction outcomes is crucial.

MCP Transaction Analyzer

A Model Context Protocol (MCP) server that provides AI-powered analysis of Ethereum transactions across any network. This service simulates transactions and generates human-readable interpretations to help users understand potential outcomes before execution.

Overview

The MCP Transaction Analyzer combines blockchain transaction simulation with AI interpretation.

• What a transaction will do before they execute it
• The potential impact on token balances
• Any hidden or unexpected outcomes
• Gas usage and cost estimates

Features

• Real-time transaction simulation using Tenderly
• AI-powered interpretation using OpenAI or Google’s Gemini models
• Support for all Ethereum-compatible networks
• Detailed analysis of:
  • ERC20, ERC721, and ERC1155 token transfers
  • Contract interactions
  • Balance changes
  • Gas estimations
• Secure HTTPS support in production
• Server-Sent Events (SSE) for real-time updates
• Full Model Context Protocol integration

Prerequisites

• Node.js >= 18.x
• SSL certificates (for production mode)
• API keys for:
  • Tenderly (transaction simulation)
  • OpenAI and/or Google Gemini (AI interpretation)

Installation

1. Clone the repository:

git clone [repository-url]
cd mcp-transaction-analyzer

2. Install dependencies:

npm install

3. Configure environment variables in .env:

TENDERLY_ACCOUNT=your_tenderly_account
TENDERLY_PROJECT=your_tenderly_project
TENDERLY_API_KEY=your_tenderly_api_key
OPENAI_API_KEY=your_openai_api_key
GEMINI_API_KEY=your_gemini_api_key
CERT_PATH=/path/to/ssl/certificates  # Required for production

Usage

Development Mode

npm run dev

Production Mode

npm run prod

Available Scripts

• npm run build - Compile TypeScript to JavaScript
• npm run dev - Run development server
• npm run dev:prod - Run production server with TypeScript
• npm run start - Start compiled server
• npm run prod - Run compiled server in production mode
• npm run inspect - Run MCP inspector on the server

Usage

Add server to Cursor

Add server to Claude Desktop

Transaction Simulation

The service accepts transaction parameters and returns detailed analysis:

{
  networkId: string,    // Network ID for the transaction
  from: string,        // Sender address
  to: string,          // Recipient address
  value?: string,      // ETH value (optional)
  data?: string,       // Transaction data (optional)
  useEmojis?: boolean  // Enable/disable emojis in response
}

for example, let’s take a random transaction from block explorer, type the following into the Cursor chat window, once you have set up your MCP server:

Computer, please determine if this transaction is safe:

networkId: 8453
from: 0x331F914d9447F0E4BEcAB98d62BEA00dADb8B591
to: 0x24fcFC492C1393274B6bcd568ac9e225BEc93584
data: 0x095ea7b3000000000000000000000000cf77a3ba9a5ca399b7c97c74d54e5b1beb874e43000000000000000000000000000000000000000000002e961634f872dfc30000

Dependencies

Core

• @modelcontextprotocol/sdk: MCP integration
• ethers: Ethereum interaction
• @smarttokenlabs/waterfall-rpc: RPC management

AI Services

• @anthropic-ai/sdk: Anthropic AI integration
• @google/generative-ai: Google Gemini integration
• openai: OpenAI integration

Server

• express: Web server framework
• @fastify/cors: CORS support

Development

• typescript: Type safety
• ts-node: TypeScript execution
• Various type definitions

Development

The project follows TypeScript best practices and is structured around:

• server.ts: Main MCP server implementation
• processTransaction.ts: Transaction analysis logic
• tenderly.ts: Tenderly API integration

License

MIT License

Author

James Brown ([email protected])

Support

For issues and feature requests, please create an issue in the repository.