MCP Tools Reference
The Scrubby tools available to your AI editor over MCP, with their parameters.
Your editor calls these tools automatically, but you can also request one by name. Authentication is handled by your editor on first connect (see Set-Up).
scrubby_index
Index a repository. In remote mode, Scrubby reads the repository from GitHub. Commit and push before indexing, since local uncommitted files aren't visible.
| Parameter | Required | Description |
|---|---|---|
repo_path | No | GitHub repository in owner/repo form (for example, ScrubbyAI/api). |
incremental | No | If true, only process changes since the last indexed commit. Defaults to false (full index). |
repo_id | No | Existing Scrubby repository ID. If omitted, Scrubby creates a new record or finds the existing one by name. |
See Indexing for how full and incremental indexes differ.
scrubby_review
Return Scrubby's knowledge for a single file: its domain patterns, segment conventions, file summaries, API surfaces, connection weights, and git history. Your editor uses this context to review the file.
| Parameter | Required | Description |
|---|---|---|
file_path | Yes | Relative path to the file within the repository. |
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_review_changeset
Review a set of changed files together and surface what the repository's history says should also change:
- Files that historically change together but are missing from the changeset.
- Cross-file consistency gaps.
- Domain boundary crossings worth checking.
| Parameter | Required | Description |
|---|---|---|
file_paths | No | File paths to review. If omitted, Scrubby auto-detects the changed files. |
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_get_domains
List all domains discovered for a repository, both repository-scoped and activated global domains, with their patterns, file counts, and languages.
| Parameter | Required | Description |
|---|---|---|
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_get_segments
List the code segments (cohesive groups of related files) with their conventions, file summaries, and API surfaces.
| Parameter | Required | Description |
|---|---|---|
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_get_network
Return the domain connection graph, with the learned weights that indicate how strongly two domains are coupled. See Domain Connections.
| Parameter | Required | Description |
|---|---|---|
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_get_findings
Return the history of commits and domain activity for a repository — which domains are most active, change velocity, and commit patterns.
| Parameter | Required | Description |
|---|---|---|
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_report_findings
Report the findings from a review back to Scrubby. Tagging each finding with a domain lets Scrubby learn which connections are valuable. See Domain Connections.
| Parameter | Required | Description |
|---|---|---|
file_path | Yes | Relative path to the file that was reviewed. |
findings | Yes | An array of findings. Each has severity (error, warning, or info) and message, and optionally domain and line. |
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |
scrubby_similar_files
Find files semantically similar to a given file, scoped to the repository and any cross-repository inclusions configured for it. Use it to find an existing implementation of a pattern before writing a new one, or to check whether a fix should also be applied elsewhere.
| Parameter | Required | Description |
|---|---|---|
file_path | Yes | Relative path to the file to find similar code for. |
limit | No | Maximum number of results. Defaults to 20, capped at 100. |
repo_id | No | Scrubby repository ID. Auto-detected if omitted. |
repo_name | No | Repository name, used to auto-resolve in remote mode. |