Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marchev--claudit/badge.svg)](/listings/marchev--claudit)

HTML

<a href="/listings/marchev--claudit"><img src="/api/listings/marchev--claudit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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)

  1. <div align="center">
  2. # claudit
  3. **Smart contract security findings for AI coding agents**
  4. Search [Solodit](https://solodit.cyfrin.io)'s 20,000+ audit findings from Claude Code and Codex CLI.
  5. [![npm version](https://img.shields.io/npm/v/@marchev/claudit?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@marchev/claudit)
  6. [![license](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
  7. [![node](https://img.shields.io/node/v/@marchev/claudit?style=flat-square&color=417e38)](package.json)
  8. [![giveth](https://img.shields.io/badge/Giveth-Support%20Claudit-5326EC?style=flat-square)](https://giveth.io/project/claudit-0)
  9. <br />
  10. [Quick Start](#quick-start) · [Tools](#tools) · [Examples](#examples) · [Configuration](#configuration)
  11. </div>
  12. ---
  13. <img src="demo.png" alt="claudit demo" width="100%" />
  14. ---
  15. ## Quick Start
  16. ```bash
  17. 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
  18. ```
  19. The installer detects Claude Code and/or Codex CLI, prompts for your [Solodit API key](https://solodit.cyfrin.io), and registers the MCP server.
  20. Then just ask:
  21. ```
  22. > Find 5 solo findings by 0x52 at Sherlock
  23. ```
  24. <details>
  25. <summary><strong>Manual install</strong></summary>
  26. ### Claude Code
  27. ```bash
  28. claude mcp add --scope user --transport stdio solodit \
  29. --env SOLODIT_API_KEY=sk_your_key_here \
  30. -- npx -y @marchev/claudit@latest
  31. # (Optional) Install companion skill
  32. mkdir -p ~/.claude/skills/solodit
  33. curl -fsSL https://raw.githubusercontent.com/marchev/claudit/main/.claude/skills/solodit/SKILL.md \
  34. -o ~/.claude/skills/solodit/SKILL.md
  35. ```
  36. ### Codex CLI
  37. ```bash
  38. codex mcp add solodit \
  39. --env SOLODIT_API_KEY=sk_your_key_here \
  40. -- npx -y @marchev/claudit@latest
  41. ```
  42. </details>
  43. ---
  44. ## Tools
  45. ### `search_findings`
  46. Search across all findings with filters.
  47. | Parameter | Type | Description |
  48. |:----------|:-----|:------------|
  49. | `keywords` | `string` | Text search in title and content |
  50. | `severity` | `string[]` | `HIGH` `MEDIUM` `LOW` `GAS` (case-insensitive) |
  51. | `firms` | `string[]` | Audit firm names |
  52. | `tags` | `string[]` | Vulnerability tags |
  53. | `language` | `string` | Programming language |
  54. | `protocol` | `string` | Protocol name (partial match) |
  55. | `reported` | `string` | `30` `60` `90` `alltime` |
  56. | `sort_by` | `string` | `Recency` `Quality` `Rarity` |
  57. | `sort_direction` | `string` | `Desc` (default) `Asc` |
  58. | `page` | `int` | Page number (default 1) |
  59. | `page_size` | `int` | Results per page (default 10, max 100) |
  60. | `advanced_filters` | `object` | See below |
  61. <details>
  62. <summary><strong>Advanced filters</strong></summary>
  63. | Field | Type | Description |
  64. |:------|:-----|:------------|
  65. | `quality_score` | `number` | Minimum quality score (0-5) |
  66. | `rarity_score` | `number` | Minimum rarity score (0-5) |
  67. | `user` | `string` | Finder/auditor handle |
  68. | `min_finders` | `number` | Minimum number of finders |
  69. | `max_finders` | `number` | Maximum number of finders |
  70. | `reported_after` | `string` | ISO date string |
  71. | `protocol_category` | `string[]` | Protocol categories |
  72. | `forked` | `string[]` | Forked protocol names |
  73. </details>
  74. ### `get_finding`
  75. Get full details for a specific finding by numeric ID, Solodit URL, or slug.
  76. ### `get_filter_options`
  77. List all valid filter values — firms, tags, categories, languages — with finding counts.
  78. ---
  79. ## Examples
  80. ```
  81. Search Solodit for oracle manipulation HIGH severity findings
  82. Find all Sherlock findings about flash loans
  83. What reentrancy issues exist in lending protocols?
  84. Show me solo findings by 0x52
  85. Get recent HIGH severity Solidity findings sorted by quality
  86. ```
  87. ---
  88. ## Configuration
  89. <details>
  90. <summary><strong>Update API key</strong></summary>
  91. **Claude Code:**
  92. ```bash
  93. claude mcp remove solodit
  94. claude mcp add --scope user --transport stdio solodit \
  95. --env SOLODIT_API_KEY=sk_new_key \
  96. -- npx -y @marchev/claudit@latest
  97. ```
  98. **Codex CLI:**
  99. ```bash
  100. codex mcp remove solodit
  101. codex mcp add solodit \
  102. --env SOLODIT_API_KEY=sk_new_key \
  103. -- npx -y @marchev/claudit@latest
  104. ```
  105. **Cursor MCP**
  106. ```json
  107. {
  108. "mcpServers": {
  109. "solodit": {
  110. "command": "npx",
  111. "args": ["-y", "@marchev/claudit@latest"],
  112. "env": {
  113. "SOLODIT_API_KEY": "sk_new_key"
  114. }
  115. }
  116. }
  117. }
  118. ```
  119. </details>
  120. <details>
  121. <summary><strong>Uninstall</strong></summary>
  122. **Claude Code:**
  123. ```bash
  124. claude mcp remove solodit
  125. rm -rf ~/.claude/skills/solodit
  126. ```
  127. **Codex CLI:**
  128. ```bash
  129. codex mcp remove solodit
  130. ```
  131. </details>
  132. <details>
  133. <summary><strong>Development</strong></summary>
  134. ```bash
  135. git clone https://github.com/marchev/claudit.git
  136. cd claudit
  137. npm install
  138. npm run build
  139. # Test locally
  140. SOLODIT_API_KEY=sk_your_key node dist/index.js
  141. ```
  142. </details>
  143. ---
  144. ## Support
  145. 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:
  146. **[giveth.io/project/claudit-0](https://giveth.io/project/claudit-0)**
  147. ---
  148. <div align="center">
  149. MIT License
  150. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.