Foundry Zksync MCP server
io.github.Jrigada/foundry-zksync·v0.2.3·1 starsExpose foundry-zksync (forge, cast, anvil-zksync) tools for zkSync Era development
1 stars43 downloads/wk
Reviews
Write oneNobody has reviewed Foundry Zksync yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Foundry Zksync tools (20, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
anvil_zksyncStart or check a local anvil-zksync development node.
cast_abi_decodeDecode ABI-encoded hex data back into human-readable values (cast abi-decode)
cast_abi_encodeABI-encode values for a given Solidity function/constructor signature (cast abi-encode)
cast_balanceQuery the ETH balance of an address (cast balance)
cast_callRead-only call to a deployed contract — no gas spent, no state change (cast call)
cast_calldata_decodeDecode raw transaction calldata (with 4-byte selector) into function arguments (cast calldata-decode)
cast_nonceQuery the transaction nonce of an address (cast nonce).
cast_sendwrite actionSend a state-changing transaction to a deployed contract (cast send)
cleanwrite actionRemove build artifacts (out/ and zkout/) from a foundry project (forge clean)
compileCompile a foundry-zksync project (forge build --zksync).
deploywrite actionDeploy a contract to a zkSync network (forge create --zksync).
explainExplain raw output from foundry-zksync: error messages, logs, or transactions.
gas_reportwrite actionRun tests and generate a gas usage report (forge test --zksync --gas-report).
get_zksync_docsLook up foundry-zksync documentation by topic. Returns URLs to the foundry-zksync book
initScaffold a new foundry project and add [profile.default.zksync] config (forge init)
installInstall dependencies for a foundry project (forge install)
read_foundry_tomlRead and return the contents of foundry.toml from a project.
run_scriptwrite actionRun a forge script targeting zkSync (forge script --zksync)
snapshotwrite actionCreate or compare gas snapshots (forge snapshot --zksync).
verifyVerify a deployed contract on a block explorer (forge verify-contract --zksync).
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan49 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 216 days ago4/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Foundry Zksync compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 48,255 servers
- Tools
- 20
- the typical server has 7
- Tools that change things
- 30%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 43
- more than 35% of 12,191 servers with a package
What its tools let an agent do: 13 read · 4 change · 3 run or deploy
Install Foundry Zksync in Claude Code, Cursor or VS Code
Runs npx -y foundry-zksync-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add foundry-zksync -- npx -y foundry-zksync-mcp
What the publisher says
From the Foundry Zksync repository's README, as published. We do not edit it. Read it on GitHub
foundry-zksync-mcp
An MCP (Model Context Protocol) server that exposes foundry-zksync CLI tools to AI assistants like Claude.
Tools
Prerequisites
- Node.js >= 18
- foundry-zksync installed (foundryup-zksync)
Quick Start (npx)
No install needed — run directly with npx:
claude mcp add foundry-zksync -- npx -y foundry-zksync-mcpOr add to claudedesktopconfig.json / ~/.claude.json:
{
"mcpServers": {
"foundry-zksync": {
"command": "npx",
"args": ["-y", "foundry-zksync-mcp"]
}
}
}Install from Source
git clone https://github.com/Jrigada/foundry-zksync-mcp.git
cd foundry-zksync-mcp
npm install
npm run buildThen register with Claude Code:
claude mcp add foundry-zksync node /absolute/path/to/foundry-zksync-mcp/dist/index.jsKey Management
All signing tools (deploy, castsend, runscript) support multiple wallet methods. Choose based on your security needs:
Local Development (anvil-zksync)
For local dev with well-known test keys, use privateKey directly:
privateKey: "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"These are the default anvil-zksync test accounts — they hold no real value.
Warning: Never use privateKey with keys that hold real funds. MCP tool parameters are visible to the AI assistant and may be logged.
Recommended for Production: Named Keystores
Keys are encrypted on disk — only the account name travels through MCP.
# Import a private key into a named keystore (interactive, key never shown)
cast wallet import deployer --interactive
# List your keystores
ls ~/.foundry/keystores/Then use account: "deployer" in any signing tool. Forge will prompt for the password at runtime, or you can point to a password file with passwordFile.
Keystore Files
If you have an existing encrypted keystore JSON file (e.g. from Geth, MetaMask export):
keystore: "/path/to/keystore.json"
passwordFile: "/path/to/password.txt"Hardware Wallets
ledger: true # Ledger
trezor: true # TrezorCloud KMS
aws: true # AWS KMS (set AWS_KMS_KEY_ID env var)
gcp: true # Google Cloud KMS (set GCP_PROJECT_ID, GCP_LOCATION, etc.)Signing Method Summary
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Foundry Zksync: common questions
- Is Foundry Zksync MCP server safe?
- Mostly: it is graded B (75/100). Read the Foundry Zksync safety report
- How do I install Foundry Zksync?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Foundry Zksync need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Foundry Zksync maintained?
- The last commit was 254 days ago (2026-02-23). The latest release is v0.2.3.
- How does Foundry Zksync compare with other MCP servers?
- safety score 75/100 (higher than 45% of 48,255 servers); tools 20 (the typical server has 7); tools that change things 30% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.