foundry-mcp

MCP server that exposes Foundry (forge, cast, anvil) CLI tools to AI assistants via the Model Context Protocol.

Prerequisites

• Node.js >= 18
• Foundry installed and available in PATH

Install

npm install -g @maliketh/foundry-mcp

Or run directly with npx:

npx @maliketh/foundry-mcp

Usage

Add to your MCP client configuration:

{
  "mcpServers": {
    "foundry": {
      "command": "npx",
      "args": ["foundry-mcp"]
    }
  }
}

The server communicates over stdio and exposes 39 tools across three categories.

Tools

Forge (17 tools)

Tool	Description
forge_init	Scaffold a new Foundry project
forge_build	Compile contracts
forge_test	Run tests with filtering, verbosity, gas reporting
forge_script	Run Solidity scripts
forge_create	Deploy contracts
forge_verify	Verify contracts on block explorers
forge_coverage	Generate coverage reports
forge_snapshot	Create gas snapshots
forge_fmt	Format Solidity code
forge_lint	Lint Solidity code
forge_clean	Remove build artifacts
forge_install	Install dependencies
forge_tree	Show dependency tree
forge_inspect	Inspect contract artifacts (ABI, bytecode, storage layout, etc.)
forge_selectors	List function selectors
forge_config	Show project configuration
forge_clone	Clone a verified contract from a block explorer

Cast (21 tools)

Tool	Description
cast_call	Call a contract function (read-only)
cast_send	Send a transaction
cast_estimate	Estimate gas for a transaction
cast_balance	Get ETH balance
cast_nonce	Get account nonce
cast_block	Get block information
cast_tx	Get transaction details
cast_receipt	Get transaction receipt
cast_gas_price	Get current gas price
cast_code	Get deployed bytecode
cast_storage	Read storage slots
cast_logs	Query event logs
cast_abi_encode	ABI-encode function arguments
cast_abi_decode	ABI-decode data
cast_calldata_decode	Decode calldata
cast_convert	Convert between formats (wei, hex, bytes32, base)
cast_keccak	Compute keccak256 hash
cast_sig	Get function selector
cast_interface	Generate Solidity interface from ABI
cast_rpc	Make raw JSON-RPC calls
cast_wallet	Generate, derive, and sign with wallets

Anvil (1 tool)

Tool	Description
anvil	Start a local devnet or check its status

Development

git clone https://github.com/jrigada/foundry-mcp.git
cd foundry-mcp
npm install
npm run build
npm test          # runs 162 tests

License

MIT