Skip to content

MCP Server

The MCP server exposes 30 tools over stdio, enabling Claude and other AI agents to query, annotate, and audit repos conversationally.

Add to .claude.json:

{
"mcpServers": {
"repo-knowledge": {
"command": "rk",
"args": ["mcp"],
"env": {}
}
}
}

Add to claude_desktop_config.json:

{
"mcpServers": {
"repo-knowledge": {
"command": "node",
"args": ["node_modules/@mcptoolshop/repo-knowledge/dist/mcp/server.js"]
}
}
}

The MCP server reads rk.config.json from the working directory at startup. Ensure the config file exists in the directory where the server process runs.

Tool Description
get_repo Full knowledge dump for a repo
find_repos Filter repos by owner, status, language, framework, shape
search_repos Full-text search across all indexed content
related_repos Show repos related to a given repo. Empty payload is { "relationships": [] } — engine state (nothing recorded), not enrichment-complete
repos_by_stack Find repos using a specific tech stack combination
repos_needing_work Find repos that need attention: stale, unaudited, warnings
repo_summary One-paragraph summary of a repo
add_repo_note Add a typed knowledge note to a repo
add_relationship Record a relationship between two repos
knowledge_stats Database statistics
sync_repos Trigger a full sync cycle
sync_dogfood Sync dogfood evidence from dogfood-lab/testing-os into repo facts
Tool Description
audit_submit Submit audit results for a repo
audit_posture Get audit posture for one repo
audit_portfolio Portfolio-wide audit posture grouped by health
audit_findings List open findings, filterable by severity and domain
audit_detail Full audit report for a repo
audit_controls_list List canonical controls by domain
audit_unaudited List repos with no audit runs

DB-only reads. These tools do not hit registries or refresh over the network; they reflect state as of the last rk sync.

Tool Description
health_feed Portfolio build-health change feed: audit deltas, unpinned actions, CI streak breaks, toolchain drift
health_doctor Single-repo build-health deep dive: CI, toolchain, dep audit, workflow actions
health_portfolio Portfolio health rollup — one row per repo with CI / dep / action-pin grades
Tool Description
db_fsck Run the DB integrity checker (orphan rows, broken relationships, FTS drift). Writes one db_health_runs row per call
repo_diff Per-repo DB-entry change history within a time window (default: last 7 days)
ops_runs List recent db_health_runs (fsck) and/or sync_runs rows
Tool Description
archive_repo Mark a repo archived. Preserves notes and findings; optional reason is recorded as a warning note
delete_repo Hard-delete a repo and related rows (FK cascade). Irreversible; confirm must be true
repo_versions List published versions already in the DB (npm / pypi / github-release). Read-only — no registry refresh
Tool Description
suggest_dogfood Dogfood intelligence suggestions (findings, patterns, recommendations, doctrine) for a repo or a product surface
audit_failing List repos whose latest audit has failing controls in a given domain

repo-knowledge is designed for parallel multi-Claude operations. Multiple agents can:

  1. Audit — claim repos from a worklist, run the 80-control audit, submit via audit_submit
  2. Enrich — add thesis, architecture notes, and relationship mappings
  3. Remediate — fix findings using a scored workflow

See templates/claude-games/ in the repo for full playbook templates.