claudit
MCP server for searching Solodit smart contract security findings
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/marchev--claudit)HTML
<a href="/listings/marchev--claudit"><img src="/api/listings/marchev--claudit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
curl -fsSL https://raw.githubusercontent.com/marchev/claudit/main/install.sh | sh
The installer detects Claude Code and/or Codex CLI, prompts for your [Solodit API key](https://solodit.cyfrin.io), and registers the MCP server.
Then just ask:
> Find 5 solo findings by 0x52 at Sherlock
<details> <summary><strong>Manual install</strong></summary>
Claude Code
claude mcp add --scope user --transport stdio solodit \ --env SOLODIT_API_KEY=sk_your_key_here \ -- npx -y @marchev/claudit@latest # (Optional) Install companion skill mkdir -p ~/.claude/skills/solodit curl -fsSL https://raw.githubusercontent.com/marchev/claudit/main/.claude/skills/solodit/SKILL.md \ -o ~/.claude/skills/solodit/SKILL.md
Codex CLI
codex mcp add solodit \ --env SOLODIT_API_KEY=sk_your_key_here \ -- npx -y @marchev/claudit@latest
</details>
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 210 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # claudit
- **Smart contract security findings for AI coding agents**
- Search [Solodit](https://solodit.cyfrin.io)'s 20,000+ audit findings from Claude Code and Codex CLI.
- [](https://www.npmjs.com/package/@marchev/claudit)
- [](LICENSE)
- [](package.json)
- [](https://giveth.io/project/claudit-0)
- <br />
- [Quick Start](#quick-start) · [Tools](#tools) · [Examples](#examples) · [Configuration](#configuration)
- </div>
- ---
- <img src="demo.png" alt="claudit demo" width="100%" />
- ---
- ## Quick Start
- ```bash
- curl -fsSL https://raw.githubusercontent.com/marchev/claudit/main/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 29 on GitHub
- ```
- The installer detects Claude Code and/or Codex CLI, prompts for your [Solodit API key](https://solodit.cyfrin.io), and registers the MCP server.
- Then just ask:
- ```
- > Find 5 solo findings by 0x52 at Sherlock
- ```
- <details>
- <summary><strong>Manual install</strong></summary>
- ### Claude Code
- ```bash
- claude mcp add --scope user --transport stdio solodit \
- --env SOLODIT_API_KEY=sk_your_key_here \
- -- npx -y @marchev/claudit@latest
- # (Optional) Install companion skill
- mkdir -p ~/.claude/skills/solodit
- curl -fsSL https://raw.githubusercontent.com/marchev/claudit/main/.claude/skills/solodit/SKILL.md \
- -o ~/.claude/skills/solodit/SKILL.md
- ```
- ### Codex CLI
- ```bash
- codex mcp add solodit \
- --env SOLODIT_API_KEY=sk_your_key_here \
- -- npx -y @marchev/claudit@latest
- ```
- </details>
- ---
- ## Tools
- ### `search_findings`
- Search across all findings with filters.
- | Parameter | Type | Description |
- |:----------|:-----|:------------|
- | `keywords` | `string` | Text search in title and content |
- | `severity` | `string[]` | `HIGH` `MEDIUM` `LOW` `GAS` (case-insensitive) |
- | `firms` | `string[]` | Audit firm names |
- | `tags` | `string[]` | Vulnerability tags |
- | `language` | `string` | Programming language |
- | `protocol` | `string` | Protocol name (partial match) |
- | `reported` | `string` | `30` `60` `90` `alltime` |
- | `sort_by` | `string` | `Recency` `Quality` `Rarity` |
- | `sort_direction` | `string` | `Desc` (default) `Asc` |
- | `page` | `int` | Page number (default 1) |
- | `page_size` | `int` | Results per page (default 10, max 100) |
- | `advanced_filters` | `object` | See below |
- <details>
- <summary><strong>Advanced filters</strong></summary>
- | Field | Type | Description |
- |:------|:-----|:------------|
- | `quality_score` | `number` | Minimum quality score (0-5) |
- | `rarity_score` | `number` | Minimum rarity score (0-5) |
- | `user` | `string` | Finder/auditor handle |
- | `min_finders` | `number` | Minimum number of finders |
- | `max_finders` | `number` | Maximum number of finders |
- | `reported_after` | `string` | ISO date string |
- | `protocol_category` | `string[]` | Protocol categories |
- | `forked` | `string[]` | Forked protocol names |
- </details>
- ### `get_finding`
- Get full details for a specific finding by numeric ID, Solodit URL, or slug.
- ### `get_filter_options`
- List all valid filter values — firms, tags, categories, languages — with finding counts.
- ---
- ## Examples
- ```
- Search Solodit for oracle manipulation HIGH severity findings
- Find all Sherlock findings about flash loans
- What reentrancy issues exist in lending protocols?
- Show me solo findings by 0x52
- Get recent HIGH severity Solidity findings sorted by quality
- ```
- ---
- ## Configuration
- <details>
- <summary><strong>Update API key</strong></summary>
- **Claude Code:**
- ```bash
- claude mcp remove solodit
- claude mcp add --scope user --transport stdio solodit \
- --env SOLODIT_API_KEY=sk_new_key \
- -- npx -y @marchev/claudit@latest
- ```
- **Codex CLI:**
- ```bash
- codex mcp remove solodit
- codex mcp add solodit \
- --env SOLODIT_API_KEY=sk_new_key \
- -- npx -y @marchev/claudit@latest
- ```
- **Cursor MCP**
- ```json
- {
- "mcpServers": {
- "solodit": {
- "command": "npx",
- "args": ["-y", "@marchev/claudit@latest"],
- "env": {
- "SOLODIT_API_KEY": "sk_new_key"
- }
- }
- }
- }
- ```
- </details>
- <details>
- <summary><strong>Uninstall</strong></summary>
- **Claude Code:**
- ```bash
- claude mcp remove solodit
- rm -rf ~/.claude/skills/solodit
- ```
- **Codex CLI:**
- ```bash
- codex mcp remove solodit
- ```
- </details>
- <details>
- <summary><strong>Development</strong></summary>
- ```bash
- git clone https://github.com/marchev/claudit.git
- cd claudit
- npm install
- npm run build
- # Test locally
- SOLODIT_API_KEY=sk_your_key node dist/index.js
- ```
- </details>
- ---
- ## Support
- Claudit is a solo-maintained public good for Ethereum security. If it saves you time or finds bugs for you, consider supporting its continued development on Giveth:
- **[giveth.io/project/claudit-0](https://giveth.io/project/claudit-0)**
- ---
- <div align="center">
- MIT License
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.