1.8.0npm · repo-context-mcp · current release
Observed 2026-08-26T10:10:40.991Z using mcpSecurity-inventory. Status: partial. Negotiated protocol: 2025-06-18.
{
"tools": {},
"resources": {},
"prompts": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
annotateAdd/remove/list project annotations (business rules, gotchas, warnings).Input schema{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"add",
"remove"
],
"description": "Action to perform"
},
"category": {
"type": "string",
"enum": [
"businessRules",
"gotchas",
"warnings"
],
"description": "Category (required for add/remove)"
},
"text": {
"type": "string",
"description": "Text to add (required for add)"
},
"index": {
"type": "number",
"description": "Index to remove (required for remove)"
}
},
"required": [
"action"
]
} | — | — · — | — |
generate_project_docsRegenerate .repo-context/ docs. Usually automatic.Input schema{
"type": "object",
"properties": {},
"required": []
} | — | — · — | — |
get_diagnosticsRun project diagnostics and return ONLY fatal errors. Auto-detects language (TypeScript, Rust, Go, Python, .NET, Java, Ruby, Swift, PHP) and runs the appropriate checker. Spelling errors and warnings are filtered out to save tokens.Input schema{
"type": "object",
"properties": {},
"required": []
} | — | — · — | — |
get_project_contextCall FIRST. Returns project context. Use section param for specific info.Input schema{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"ultra",
"compact",
"normal",
"minimal",
"json"
],
"description": "Output format (default: compact)"
},
"section": {
"type": "string",
"enum": [
"all",
"stack",
"structure",
"endpoints",
"models",
"status",
"hotfiles",
"modified",
"imports",
"annotations"
],
"description": "Specific section (default: all). Use \"modified\" for git-modified files only."
},
"force_refresh": {
"type": "boolean",
"description": "Force re-analysis"
}
},
"required": []
} | — | — · — | — |
list_filesList files/dirs. Respects .gitignore.Input schema{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Dir path (default: root)"
},
"pattern": {
"type": "string",
"description": "Glob filter"
},
"max_depth": {
"type": "number",
"description": "Depth (default: 3)"
}
},
"required": []
} | — | — · — | — |
read_fileSmart reader. <200L: full content. >200L: outline. Optional line range.Input schema{
"type": "object",
"properties": {
"file": {
"type": "string",
"description": "Relative path to file"
},
"start_line": {
"type": "number",
"description": "Start line"
},
"end_line": {
"type": "number",
"description": "End line"
}
},
"required": [
"file"
]
} | — | — · — | — |
read_file_outlineFile outline: symbols with line ranges (~100 tokens). Use depth=1 for top-level only (~80t vs ~450t on complex files).Input schema{
"type": "object",
"properties": {
"file": {
"type": "string",
"description": "Relative path"
},
"depth": {
"type": "number",
"description": "Symbol depth: 1 = top-level only (no nested consts/functions). Reduces ~450t to ~80t for complex files."
}
},
"required": [
"file"
]
} | — | — · — | — |
read_file_symbolRead function/class by name. Fuzzy matching supported.Input schema{
"type": "object",
"properties": {
"file": {
"type": "string",
"description": "Relative path"
},
"symbol": {
"type": "string",
"description": "Symbol name"
}
},
"required": [
"file",
"symbol"
]
} | — | — · — | — |
search_in_fileSearch pattern in file. Regex supported.Input schema{
"type": "object",
"properties": {
"file": {
"type": "string",
"description": "Relative path"
},
"pattern": {
"type": "string",
"description": "Pattern (string/regex)"
},
"context_lines": {
"type": "number",
"description": "Context lines (default: 2)"
},
"max_matches": {
"type": "number",
"description": "Max matches (default: 50)"
}
},
"required": [
"file",
"pattern"
]
} | — | — · — | — |
search_in_projectSearch across all project files. Default: 1-line compact output — total matches, file count, top 10 hottest files. Use max_files=N for code detail on N files. Use max_files=-1 with file_pattern to get all matching files grouped and sorted (replaces grep).Input schema{
"type": "object",
"properties": {
"pattern": {
"type": "string",
"description": "Pattern (string/regex)"
},
"file_pattern": {
"type": "string",
"description": "Glob filter. Supports multi-glob: \"*.ts,*.tsx\" or brace expansion \"*.{ts,tsx}\". With max_files=-1 acts as grep replacement"
},
"max_results": {
"type": "number",
"description": "Max matches shown per file in detail (default: 30)"
},
"context_lines": {
"type": "number",
"description": "Context lines around each match (default: 0)"
},
"max_files": {
"type": "number",
"description": "Files to show code detail for (default: 0 = compact summary only). Use max_files=5 to see code. Use max_files=-1 with file_pattern to show ALL matching files grouped by file, sorted by match count — respects .gitignore, skips binaries."
},
"exclude_pattern": {
"type": "string",
"description": "Glob pattern to exclude files (e.g. \"*.md\", \"docs/**\"). Comma-separated for multiple patterns."
}
},
"required": [
"pattern"
]
} | — | — · — | — |
search_symbolSearch for a symbol (function, class, interface, type, const, enum) across ALL project files. Returns file location, type, signature, and exported status. Fuzzy matching supported.Input schema{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Symbol name(s) to search for. Comma-separated for multi-search: \"handleDelete,handleEdit\". Supports fuzzy matching."
},
"type": {
"type": "string",
"description": "Filter by symbol type",
"enum": [
"function",
"class",
"interface",
"type",
"const",
"enum",
"method",
"export"
]
},
"exported_only": {
"type": "boolean",
"description": "Only return exported symbols (default: false)"
}
},
"required": [
"name"
]
} | — | — · — | — |
REST/GraphQL endpoints if detected.
{
"resource_key": "repo://context/api",
"uri": "repo://context/api",
"name": "API Endpoints",
"description": "REST/GraphQL endpoints if detected.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "7065cbe1f1c62985f6071b8308d2e3205699957a156232e0f8b8ac856b817064"
}Schemas, types, and interfaces.
{
"resource_key": "repo://context/models",
"uri": "repo://context/models",
"name": "Data Models",
"description": "Schemas, types, and interfaces.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "4c0c2d624231a031a467c642de3c4eabbfe479236c1d881380ab67e9f56f5a0a"
}All source file outlines: functions, classes, interfaces with line ranges. Use to navigate large files.
{
"resource_key": "repo://context/outlines",
"uri": "repo://context/outlines",
"name": "File Outlines",
"description": "All source file outlines: functions, classes, interfaces with line ranges. Use to navigate large files.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "70fcdc0927f508f950f95ea43725075c2f20ba0e771f565ef4a959267f6b9cef"
}Complete project analysis in compact format.
{
"resource_key": "repo://context/full",
"uri": "repo://context/full",
"name": "Full Project Context",
"description": "Complete project analysis in compact format.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "c20900df91dcc2f489885625b9654b75920b1ec3a899b4feb1ed15d95f4c8f29"
}Large/complex files that need special attention.
{
"resource_key": "repo://context/hotfiles",
"uri": "repo://context/hotfiles",
"name": "Hot Files",
"description": "Large/complex files that need special attention.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "b336211a3a326d05dd66ff7a70ab0f0755f65a5f0584bcc340a1d04e454589b1"
}Internal dependency graph: hub files, orphan files.
{
"resource_key": "repo://context/imports",
"uri": "repo://context/imports",
"name": "Import Graph",
"description": "Internal dependency graph: hub files, orphan files.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "af316d716c88b6dfec42aedcab2649c9aae8d137689c81708e86dc34fc7982c8"
}Human-written business rules, gotchas, and warnings.
{
"resource_key": "repo://context/annotations",
"uri": "repo://context/annotations",
"name": "Project Annotations",
"description": "Human-written business rules, gotchas, and warnings.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "832efdecc3fd544a06a9c9bfd11ce2f79d03baa4f03b4ff620c94130ccf98f08"
}Full context in JSON format for programmatic use.
{
"resource_key": "repo://context.json",
"uri": "repo://context.json",
"name": "Project Context (JSON)",
"description": "Full context in JSON format for programmatic use.",
"mime_type": "application/json",
"annotations": null,
"metadata_hash": "c809906eb114648f23f78be21e8a75294bd774b97a9840a068a1c9e391ef006f"
}Folder layout and entry points.
{
"resource_key": "repo://context/structure",
"uri": "repo://context/structure",
"name": "Project Structure",
"description": "Folder layout and entry points.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "5450ea43b2a97f140cea7c4b6f7b647f856adf889a274c86f9ec9a9bee035355"
}Ultra-compact project summary (~50 tokens). Embed this for instant context.
{
"resource_key": "repo://context/summary",
"uri": "repo://context/summary",
"name": "Project Summary",
"description": "Ultra-compact project summary (~50 tokens). Embed this for instant context.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "302e861d329d04e81a79530b294a751dd56656bc1ff1f3344bc6755053c972b2"
}Languages, frameworks, and dependencies.
{
"resource_key": "repo://context/stack",
"uri": "repo://context/stack",
"name": "Tech Stack",
"description": "Languages, frameworks, and dependencies.",
"mime_type": "text/plain",
"annotations": null,
"metadata_hash": "3cc876893d89c95dd180f66f758fbf91d5b22ea490d77e9d1063dd01ffd362f5"
}Injects instructions for efficient file reading. Use for large files.
{
"prompt_key": "file-reader-guide",
"name": "file-reader-guide",
"description": "Injects instructions for efficient file reading. Use for large files.",
"arguments": [],
"metadata_hash": "269f25eb8f5b896f1f78639e474caf96bbf626cd9296e585b95c866d705208ca"
}Injects project context into conversation. Use at start.
{
"prompt_key": "project-context",
"name": "project-context",
"description": "Injects project context into conversation. Use at start.",
"arguments": [
{
"name": "format",
"description": "Output format: minimal, ultra, compact (default)",
"required": false
}
],
"metadata_hash": "41f633fc0caab927877fe7ff6bed8a1a2067a4560104b220f1b66d3e78c8a4ba"
}Ultra-minimal project summary (~50 tokens)
{
"prompt_key": "project-summary",
"name": "project-summary",
"description": "Ultra-minimal project summary (~50 tokens)",
"arguments": [],
"metadata_hash": "b12e5a9a5718dab9c174e1b7e19431c9f306d4de4fd07d2366384079ce28987f"
}