foundry-mcp-server

Overview

This is a robust MCP server that connects LLM assistants to the Foundry ecosystem, enabling blockchain development and analysis capabilities. It provides extensive tools for interacting with nodes, analyzing smart contracts, performing EVM operations, and managing Solidity code. The server maintains a persistent Forge workspace and supports both local Anvil instances and remote RPC endpoints.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• anvil_start

  Start a new Anvil instance

  Try:Start a new Anvil instanceTry:Launch a local blockchain node with Anvil
• anvil_stop

  Stop a running Anvil instance

  Try:Stop the current Anvil instanceTry:Terminate the local blockchain node
• anvil_status

  Check if Anvil is running and get its status

  Try:Check if Anvil is runningTry:What's the status of the local blockchain node?
• cast_call

  Call a contract function (read-only)

  Try:Call the balanceOf function on a contractTry:Execute a read-only contract function
• cast_send

  Send a transaction to a contract function

  Try:Send a transaction to transfer tokensTry:Execute a contract function that modifies state
• cast_balance

  Check the ETH balance of an address

  Try:Check the ETH balance of 0x123...456Try:What's the balance of this wallet?
• forge_script

  Run a Forge script from the workspace

  Try:Run the deployment script in ForgeTry:Execute a Forge script in my workspace
• create_solidity_file

  Create or update a Solidity file in the workspace

  Try:Create a new Solidity contract fileTry:Update an existing smart contract
• heimdall_disassemble

  Disassemble EVM bytecode into human-readable opcodes

  Try:Disassemble this contract bytecodeTry:Show me the opcodes for this contract
• heimdall_decompile

  Decompile EVM bytecode to Solidity source code and ABI

  Try:Decompile this bytecode to SolidityTry:What's the original source code of this contract?
• estimate_gas

  Estimate the gas cost of a transaction

  Try:Estimate gas for this transactionTry:How much gas would this transfer cost?
• convert_eth_units

  Convert between EVM units (wei, gwei, hex)

  Try:Convert 1 ETH to weiTry:What's 100 gwei in ETH?

Comparable tools

Installation

npm install -g @pranesh.asp/foundry-mcp-server

{
  "mcpServers": {
    "foundry": {
      "command": "npx",
      "args": ["@pranesh.asp/foundry-mcp-server"],
      "env": {
        "RPC_URL": "http://localhost:8545",
        "PRIVATE_KEY": "0x..."
      }
    }
  }
}

FAQ

Is it safe to provide my PRIVATE_KEY to the MCP server?

No, do not add keys with mainnet funds. The code uses keys safely, but LLMs can hallucinate and send malicious transactions. Only use for testing/development purposes.

What makes this MCP server unique for Solidity development?

It provides a comprehensive set of tools for the entire Solidity development lifecycle - from writing code and managing dependencies to deploying contracts and analyzing transactions - all accessible through MCP clients.

Compare foundry-mcp-server with