jrigada avatar

Foundry Zksync

jrigada/foundry-zksync-mcp

Wraps the full foundry-zksync toolchain (forge, cast, anvil-zksync) for zkSync Era smart contract work. You get 21 tools covering the standard workflow: init projects with zkSync config, compile and test with zksync flags, deploy and verify contracts, manage dependencies, run scripts with broadcast options, and decode ABIs. The deploy tool parses output into structured fields. Signing operations support hardware wallets, named keystores, and cloud KMS alongside raw private keys for local testing. Also includes a knowledge base of 45+ zkSync gotchas with an explain tool that matches errors and logs against common issues, plus embedded documentation lookup for foundry-zksync specifics.

GitHub stars
1
tools
21
transport
STDIO
last updated
Feb 23, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

init`forge init` with automatic zkSync config

`forge init` with automatic zkSync config

No parameter schema in public metadata yet.

compile`forge build --zksync`

`forge build --zksync`

No parameter schema in public metadata yet.

test`forge test --zksync` with filter/verbosity options

`forge test --zksync` with filter/verbosity options

No parameter schema in public metadata yet.

run_script`forge script --zksync` with broadcast, sender, slow mode

`forge script --zksync` with broadcast, sender, slow mode

No parameter schema in public metadata yet.

deploy`forge create --zksync` with structured output parsing

`forge create --zksync` with structured output parsing

No parameter schema in public metadata yet.

verify`forge verify-contract --zksync` (Etherscan & zkSync Explorer)

`forge verify-contract --zksync` (Etherscan & zkSync Explorer)

No parameter schema in public metadata yet.

install`forge install` for dependency management

`forge install` for dependency management

No parameter schema in public metadata yet.

clean`forge clean` to remove build artifacts

`forge clean` to remove build artifacts

No parameter schema in public metadata yet.

gas_report`forge test --gas-report` for gas usage analysis

`forge test --gas-report` for gas usage analysis

No parameter schema in public metadata yet.

snapshot`forge snapshot` for gas benchmarking

`forge snapshot` for gas benchmarking

No parameter schema in public metadata yet.

read_foundry_tomlRead and inspect project configuration

Read and inspect project configuration

No parameter schema in public metadata yet.

explainMatch errors/logs against a knowledge base of zkSync gotchas

Match errors/logs against a knowledge base of zkSync gotchas

No parameter schema in public metadata yet.

cast_abi_encode`cast abi-encode`

`cast abi-encode`

No parameter schema in public metadata yet.

cast_abi_decode`cast abi-decode`

`cast abi-decode`

No parameter schema in public metadata yet.

cast_calldata_decode`cast calldata-decode`

`cast calldata-decode`

No parameter schema in public metadata yet.

cast_call`cast call` for read-only contract interaction

`cast call` for read-only contract interaction

No parameter schema in public metadata yet.

cast_send`cast send` for state-changing transactions

`cast send` for state-changing transactions

No parameter schema in public metadata yet.

cast_balance`cast balance` for ETH balance queries

`cast balance` for ETH balance queries

No parameter schema in public metadata yet.

cast_nonce`cast nonce` for transaction nonce queries

`cast nonce` for transaction nonce queries

No parameter schema in public metadata yet.

get_zksync_docsLook up foundry-zksync documentation by topic

Look up foundry-zksync documentation by topic

No parameter schema in public metadata yet.

anvil_zksyncStart or check a local anvil-zksync dev node

Start or check a local anvil-zksync dev node

No parameter schema in public metadata yet.

Sponsors

Readme

foundry-zksync-mcp

An MCP (Model Context Protocol) server that exposes foundry-zksync CLI tools to AI assistants like Claude.

Tools


View the full README on GitHub

Details

Repository
github.com/jrigada/foundry-zksync-mcp
Package
foundry-zksync-mcp
Transport
STDIO
Registry
MCP registry, active