codebase-doctor
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| audit_codebaseA | Run the full built-in Codebase Doctor audit on a repository and return the evidence-backed report. Read-only and offline by default; it never enables validation commands (--run-checks) or live database access (--with-database). |
| describe_capabilitiesA | Describe this MCP server: available tools, the nine audit domains in the domainCoverage inventory, the Doctor capability vocabulary, and the permissions this server never grants. |
| verify_changesA | Verify that findings from a prior schema-1 JSON report are repaired. Runs a fresh read-only audit, compares fingerprints, and reports each baseline finding as resolved, unchanged, or unresolved. Absence under incomplete coverage is unresolved, never resolved. Read-only and offline by default; it never enables validation commands or live database access. |
| explain_findingA | Return the full evidence, remediation guidance, and verification command for one finding, selected by fingerprint or rule id. Read-only and offline. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a fairly distinct purpose: audit_codebase runs the full audit, verify_changes compares fingerprints against a baseline, explain_finding drills into one finding, and describe_capabilities is meta. The only mild overlap is that audit_codebase and verify_changes both execute a read-only audit, but their descriptions make the baseline-vs-verification distinction clear.
All four tools follow a clean verb_noun snake_case pattern (audit_codebase, describe_capabilities, verify_changes, explain_finding), with no mixed conventions or vague verbs.
Four tools is a tightly scoped, coherent set for a read-only audit workflow (run, explain, verify, describe). It is on the lean side but each tool earns its place, so it lands slightly below ideal breadth rather than being bloated.
The surface covers the core audit lifecycle: run an audit, inspect individual findings, verify repairs, and introspect the server's capabilities. A dedicated findings-listing tool is absent, but findings are surfaced through the report and explain_finding, so agents can work around it; read-only design legitimately omits write operations.