Foundry MCP Server
@PraneshASP
About Foundry MCP Server
An experimental MCP Server for foundry built for Solidity devs
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"foundry-mcp-server": {
"command": "npx",
"args": [
"@pranesh.asp/foundry-mcp-server"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Foundry MCP Server?
Foundry MCP Server is a lightweight MCP server that connects LLM assistants to the Foundry toolchain (Forge, Cast, Anvil), enabling Solidity development and onchain operations. It is designed for developers who want to interact with Ethereum nodes, analyze smart contracts, and manage Solidity code through natural language interfaces.
How to use Foundry MCP Server?
Install globally via npm install -g @pranesh.asp/foundry-mcp-server or run directly with npx @pranesh.asp/foundry-mcp-server. Configure your MCP client (e.g., Claude Desktop, Cursor) by adding a "foundry" entry under mcpServers in your client’s configuration file, providing the command npx with arguments and optional environment variables RPC_URL and PRIVATE_KEY. The server uses STDIO transport and requires Node.js v18+, the Foundry toolchain, and optional Heimdall-rs for advanced analysis.
Key features of Foundry MCP Server
- Start and manage local Anvil instances
- Connect to remote RPC endpoints and query chain info
- Call contract functions (read-only) and send transactions
- Maintain a persistent Forge workspace at
~/.mcp-foundry-workspace - Create, edit, and deploy Solidity files and scripts
- Disassemble, decode, and decompile EVM bytecode via Heimdall
Use cases of Foundry MCP Server
- Analyze on-chain transactions and explain their behavior
- Query token balances (e.g., ETH and USDT) for any wallet
- Deploy mock ERC20 contracts to a local Anvil instance
- Run Forge scripts and manage Solidity dependencies
FAQ from Foundry MCP Server
What runtime and tools does Foundry MCP Server require?
Node.js v18+, the Foundry toolchain (Forge, Cast, Anvil), and optionally Heimdall-rs for contract analysis.
Is a private key required to use the server?
No, the PRIVATE_KEY environment variable is optional. If set, it enables sending transactions. The README strongly advises against using keys with mainnet funds due to LLM hallucination risks.
Where does the server store Solidity files and projects?
It maintains a persistent Forge workspace at ~/.mcp-foundry-workspace for all Solidity files, scripts, and dependencies.
How do I configure a client like Claude Desktop?
Add a JSON entry under mcpServers with command npx, arguments ["@pranesh.asp/foundry-mcp-server"], and optional environment variables for RPC_URL and PRIVATE_KEY. Ensure valid JSON syntax.
What transport protocol does Foundry MCP Server use?
It uses STDIO transport, as shown in the MCP client configuration examples.
Frequently asked questions
What runtime and tools does Foundry MCP Server require?
Node.js v18+, the Foundry toolchain (Forge, Cast, Anvil), and optionally Heimdall-rs for contract analysis.
Is a private key required to use the server?
No, the `PRIVATE_KEY` environment variable is optional. If set, it enables sending transactions. The README strongly advises against using keys with mainnet funds due to LLM hallucination risks.
Where does the server store Solidity files and projects?
It maintains a persistent Forge workspace at `~/.mcp-foundry-workspace` for all Solidity files, scripts, and dependencies.
How do I configure a client like Claude Desktop?
Add a JSON entry under `mcpServers` with command `npx`, arguments `["@pranesh.asp/foundry-mcp-server"]`, and optional environment variables for `RPC_URL` and `PRIVATE_KEY`. Ensure valid JSON syntax.
What transport protocol does Foundry MCP Server use?
It uses STDIO transport, as shown in the MCP client configuration examples.
Basic information
More Other MCP servers
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Codelf
unbugA search tool helps dev to solve the naming things problem.
AutoBrowser MCP
autobrowser-aiBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Comments