solidity-agent-toolkit

MCP server + LSP server + Agent Skills providing Solidity smart contract security analysis tools, OWASP knowledge base, and development utilities for AI agents.

Built on Model Context Protocol and Language Server Protocol — works with Claude Desktop, Cursor, opencode, VSCode, IntelliJ, Neovim, and any MCP/LSP-compatible client.

Quick Start

# Run MCP server (no install needed)
npx solidity-agent-toolkit

# Install Agent Skills for AI coding agents
npx skills add whackur/solidity-agent-toolkit

MCP Client Config (Claude Desktop, Cursor, etc.)

{
  "mcpServers": {
    "solidity-agent-toolkit": {
      "command": "npx",
      "args": ["-y", "solidity-agent-toolkit@latest"]
    }
  }
}

See MCP Setup for client-specific instructions.

Features

10 MCP Tools — Security analysis (Slither, Aderyn, Solhint, pattern matching), compilation & testing (Foundry), gas & storage inspection, dry-run deployment, code quality (NatSpec, style, formatting)

12 MCP Resources — OWASP Smart Contract Top 10, SCWE vulnerability database (156 entries), ERC standard interfaces, adversarial scenarios, Slither detectors, Solhint rules

7 MCP Prompts — Security audit, vulnerability fix, code review, best practices, gas optimization, ERC generation, adversarial analysis

LSP Server — Real-time pattern diagnostics, CLI diagnostics on save, OWASP SCWE hover info, remediation code actions

7 Agent Skills — Security best practices, Foundry development, Hardhat development, gas optimization, code review methodology, ERC standards, adversarial analysis

Documentation

| Document | Description | | -------------------------------------- | -------------------------------------------------- | | Installation | Install, update, uninstall, version pinning | | MCP Setup | Claude Desktop, Cursor, opencode, VSCode, IntelliJ | | LSP Setup | VSCode, IntelliJ, Neovim, Sublime Text | | API Reference | All tools, resources, and prompts | | Agent Skills | Skill descriptions and installation | | Development | Prerequisites, commands, architecture |

License

MIT