v1.0.0: The MCP Architecture
This major release transforms the repository from a collection of Markdown skills into a professional, production-ready Model Context Protocol (MCP) Server.
evm-agent-toolkit now provides autonomous coding agents (Claude, Cursor, Gemini, etc.) with deterministic, schema-validated wrappers around standard EVM CLI tools toprevent LLM hallucinations during analysis.
✨ Key Features
- New MCP Server Architecture: Fully typed TypeScript backend using the official
@modelcontextprotocol/sdk. - Zod-Validated Parsers: Noisy stdout from CLI tools is now intercepted, validated via Zod schemas, and returned as clean JSON.
- NPM Package: Published to the public registry. Agents can now initialize the server effortlessly via
npx -y @0xendale/evm-agent-toolkit.
🛠️ Core Tools
evm_scan_vulnerabilities: Runs Slither and extracts specific code snippets for high/medium severity findings.evm_analyze_gas_profile: Parsesforge test --gas-reportinto structured JSON per-function gas tables.evm_compile_and_diagnose: Executesforge buildand returns structured compiler diagnostics on failure.evm_simulate_transaction: Simulates read-only node calls viacast callreturning decoded return data or revert strings.
📚 Knowledge Resources
Agents can now natively read EVM heuristics via the MCP resource API:
evm://patterns/vulnerabilitiesevm://gas/optimizationsevm://patterns/arbitrage
⚙️ Engine Improvements
- Replaced legacy Zod
.passthrough()with v4 strictz.looseObject()schemas. - Added standard MCP tool annotations (
readOnlyHint,idempotentHint). - Added
CHARACTER_LIMITtruncation to protect LLM context windows from massive Slither outputs. - Strict
stderrlogging separation to maintainstdiotransport integrity.