Labsco
PraneshASP logo

Foundry MCP Server

★ 250

from PraneshASP

A lightweight MCP server for Solidity development using the Foundry toolchain (Forge, Cast, and Anvil).

🔥🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#git#search

Foundry MCP Server

A simple, lightweight and fast MCP (Model Context Protocol) server that provides Solidity development capabilities using the Foundry toolchain (Forge, Cast, and Anvil).

Foundry MCP Demo

Overview

This server connects LLM assistants to the Foundry ecosystem, enabling them to:

  • Interact with nodes (local Anvil instances or remote RPC endpoints)
  • Analyze smart contracts and blockchain data
  • Perform common EVM operations using Cast
  • Manage, deploy, and execute Solidity code and scripts
  • Work with a persistent Forge workspace

Features

Network Interaction

  • Start and manage local Anvil instances
  • Connect to any remote network (just specify the RPC)
  • Get network/chain information

Contract Interaction

  • Call contract functions (read-only)
  • Send transactions to contracts (if PRIVATE_KEY is configured)
  • Get transaction receipts
  • Read contract storage
  • Analyze transaction traces
  • Retrieve contract ABIs and sources from block explorers

Solidity Development

  • Maintain a dedicated Forge workspace
  • Create and edit Solidity files
  • Install dependencies
  • Run Forge scripts
  • Deploy contracts

Utility Functions

  • Calculate contract addresses
  • Check contract bytecode size
  • Estimate gas costs
  • Convert between units (hex to decimals, etc.,)
  • Generate wallets
  • Get event logs
  • Lookup function and event signatures

Smart Contract Analysis (Heimdall)

  • Disassemble EVM bytecode into human-readable opcodes
  • Decode raw calldata without requiring ABI
  • Decompile EVM bytecode to Solidity source code and ABI
  • Generate visual control flow graphs for EVM bytecode
  • Detailed transaction inspection with calldata decoding and trace analysis

Tools

Anvil

  • anvil_start: Start a new Anvil instance
  • anvil_stop: Stop a running Anvil instance
  • anvil_status: Check if Anvil is running and get its status

Cast

  • cast_call: Call a contract function (read-only)
  • cast_send: Send a transaction to a contract function
  • cast_balance: Check the ETH balance of an address
  • cast_receipt: Get the transaction receipt
  • cast_storage: Read contract storage at a specific slot
  • cast_run: Run a published transaction in a local environment
  • cast_logs: Get logs by signature or topic
  • cast_sig: Get the selector for a function or event signature
  • cast_4byte: Lookup function or event signature from the 4byte directory
  • cast_chain: Get information about the current chain

Forge

  • forge_script: Run a Forge script from the workspace
  • install_dependency: Install a dependency for the Forge workspace

File Management

  • create_solidity_file: Create or update a Solidity file in the workspace
  • read_file: Read the content of a file from the workspace
  • list_files: List files in the workspace

Utilities

  • convert_eth_units: Convert between EVM units (wei, gwei, hex)
  • compute_address: Compute the address of a contract that would be deployed
  • contract_size: Get the bytecode size of a deployed contract
  • estimate_gas: Estimate the gas cost of a transaction

Heimdall Analysis

  • heimdall_disassemble: Disassemble EVM bytecode into human-readable opcodes
  • heimdall_decode: Decode raw calldata without requiring ABI
  • heimdall_decompile: Decompile EVM bytecode to Solidity source code and ABI
  • heimdall_cfg: Generate visual control flow graph for EVM bytecode
  • heimdall_inspect: Detailed inspection of Ethereum transactions

Disclaimer

The software is being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the software. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. The creators are not liable for any of the foregoing. Users should proceed with caution and use at their own risk.