Skip to content

Releases: 0xendale/evm-agent-toolkit

v1.1.0

Choose a tag to compare

@0xendale 0xendale released this 10 Jul 04:18
fd8d197

v1.1.0

New tools (5)

  • evm_inspect_storage_layout — forge storage layout for proxy-collision/packing checks
  • evm_trace_call — structured call tree from cast call --trace
  • evm_decode_calldata — offline/selector-lookup calldata decoding
  • evm_run_tests — structured forge test results with fuzz counterexamples
  • evm_toolchain_versions — prerequisite + reproducibility preflight

New MCP prompts (3)

audit_contract, optimize_gas, analyze_arbitrage — skill workflows for clients without native skill support

Security & fixes

  • Shell injection eliminated: execexecFile array args across all tools; address/URL input validation
  • Resource paths resolved from package root (npx installs no longer break evm:// resources)
  • evm_compile_and_diagnose no longer reports success: true on compile failure
  • Boundary-safe truncation + severityFilter/maxFindings/detectors on scan tool
  • outputSchema + structuredContent on all 9 tools

32/32 tests. Verified end-to-end via stdio smoke tests against real Foundry project.

v1.0.0: The MCP Architecture

Choose a tag to compare

@0xendale 0xendale released this 09 Jul 08:26

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: Parses forge test --gas-report into structured JSON per-function gas tables.
  • evm_compile_and_diagnose: Executes forge build and returns structured compiler diagnostics on failure.
  • evm_simulate_transaction: Simulates read-only node calls via cast call returning decoded return data or revert strings.

📚 Knowledge Resources

Agents can now natively read EVM heuristics via the MCP resource API:

  • evm://patterns/vulnerabilities
  • evm://gas/optimizations
  • evm://patterns/arbitrage

⚙️ Engine Improvements

  • Replaced legacy Zod .passthrough() with v4 strict z.looseObject() schemas.
  • Added standard MCP tool annotations (readOnlyHint, idempotentHint).
  • Added CHARACTER_LIMIT truncation to protect LLM context windows from massive Slither outputs.
  • Strict stderr logging separation to maintain stdio transport integrity.