Install socraticode from npm
Install exact version 1.12.0. No verified executable entrypoint is available, so use the package documentation to launch it.
npm install --save-exact socraticode@1.12.0MCP server intelligence profile
SocratiCode MCP Server
Enterprise-grade (40m+ lines) codebase intelligence in a zero-setup, private and local MCP: managed indexing, hybrid semantic search, polyglot code dependency graphs, and DB/API/infra knowledge. Benchmark: 61% less tokens, 84% fewer calls, 37x faster than standard AI grep
1Distribution channel
25Independently observed tools
0Linked remote endpoints
AvailableVersion intelligence
Detailed security scan evidence is not public for this MCP yet. Public identity, registry metadata, and independently observed protocol inventory remain available.
Install and connect
Installation and connection instructions are shown only when supported by retained package, repository, or endpoint evidence.
Identity
| Canonical slug | socraticode-4589e5d7 | Deployment | Local Only |
|---|---|---|---|
| Canonical package | npm:socraticode | Repository | giancarloerra/SocratiCode |
| First published | Aug 5, 2026 | Latest release | Aug 5, 2026 |
| Last security verification | — | Classification confidence | 90% |
| Publication | Draft | Official distribution | Not verified |
Distributions
| Channel | Identifier | Current version | Versions | Source |
|---|---|---|---|---|
| npm | socraticode | 1.12.0 | 43 | Repository |
Current release
| Package | Version | Published / observed | Inventory | Security scan |
|---|---|---|---|---|
| npmsocraticode | 1.12.0Current | Sep 5, 2026 | 25 toolsSucceeded · 0 resources · 0 prompts | Evidence restricted |
Enterprise protection
Continuously monitor this MCP for security risk
Independently scan the exact version your agents use, receive alerts when its risk changes, and investigate every finding with retained version evidence.
- Independent exact-version security scans
- Continuous release and vulnerability monitoring
- Risk-change alerts with capability context
- Historical evidence and API exports
Custom pricingContact salesTailored to your organization, integrations, data needs, and support requirements.
Current version evidence
No public current-version evidence is available yet.
Current protocol inventory
2025-06-18Negotiated protocol
socraticodeServer-reported name
1Capability groups
Aug 21, 2026Observed
Tools 25
| Tool | Category | Annotations | Risk |
|---|---|---|---|
codebase_aboutDisplay information about SocratiCode — what it is, its tools and how to use it. Use this to get a quick overview of the MCP tools and their purpose.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
} | — | — | |
codebase_contextList all context artifacts defined in .socraticodecontextartifacts.json — database schemas, API specs, infra configs, architecture docs, etc. Shows each artifact's name, description, path, and index status. Use this to discover what project knowledge is available beyond source code.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory. If omitted, uses the current working directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_context_indexIndex or re-index all context artifacts defined in .socraticodecontextartifacts.json. Chunks and embeds artifact content into the vector database for semantic search. Usually not needed — codebase_context_search auto-indexes on first use.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_context_removeRemove all indexed context artifacts for a project from the vector database. Blocked while indexing is in progress — use codebase_stop or wait for the operation to finish first.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"required": [
"projectPath"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_context_searchSemantic search across context artifacts (database schemas, API specs, infra configs, etc.) defined in .socraticodecontextartifacts.json. Auto-indexes on first use and auto-detects stale artifacts. Use this to find relevant infrastructure or domain knowledge.Input schema{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural language search query (e.g. 'tables related to billing', 'authentication endpoints', 'deployment resource limits')."
},
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"artifactName": {
"type": "string",
"description": "Filter search to a specific artifact by name (e.g. 'database-schema'). Omit to search across all artifacts."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 50,
"description": "Maximum number of results to return. Default: 10."
},
"minScore": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Minimum RRF score threshold (0-1). Results below this are filtered out. Default: 0.10 (override globally via SEARCH_MIN_SCORE env var). Set to 0 to disable filtering."
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_flowTrace the EXECUTION FLOW forward from an entry point — what does this code call into? With NO args, returns a ranked list of auto-detected entry points (orphans with outgoing calls, conventional names like main(), framework routes, tests). With an entrypoint argument, returns the call tree.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"entrypoint": {
"type": "string",
"description": "Symbol name to trace from. Omit to list auto-detected entry points."
},
"file": {
"type": "string",
"description": "Optional file hint to disambiguate the symbol."
},
"depth": {
"type": "number",
"description": "Maximum DFS depth (default 5, max 10)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_buildBuild a dependency graph of the codebase using static analysis (ast-grep). Maps import/require/export relationships between files. Runs in the background — call codebase_graph_status to poll progress until complete.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"extraExtensions": {
"type": "string",
"description": "Comma-separated list of additional file extensions to include in the graph (e.g. '.tpl,.blade'). Files with non-standard extensions are included as leaf nodes (dependency targets). Can also be set globally via EXTRA_EXTENSIONS env var."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_circularFind circular dependencies in the codebase.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_queryQuery the code dependency graph for a specific file. Returns what the file imports and what files depend on it.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"filePath": {
"type": "string",
"description": "Relative path of the file to query (e.g. 'src/index.ts')."
}
},
"required": [
"filePath"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_removeRemove a project's persisted code graph. Waits for any in-flight graph build to finish first. The graph can be rebuilt with codebase_graph_build or will be rebuilt automatically on the next codebase_index.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"required": [
"projectPath"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_statsGet statistics about the code dependency graph: total files, edges, most connected files, orphan files, circular dependencies.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_statusCheck the status of the code dependency graph: build progress (if building), node/edge count, when it was last built, whether it's cached in memory. Use this to poll progress after calling codebase_graph_build.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_graph_visualizeVisualise the code dependency graph. Two modes:
• mode="mermaid" (default) — returns a Mermaid diagram (text) colour-coded by language, circular deps highlighted. Best for inline rendering inside chat, GitHub, or editors that render Mermaid.
• mode="interactive" — writes a self-contained HTML page (vendored Cytoscape.js + Dagre, works offline) and opens it in the user's default browser. Shows the file graph and, when a symbol graph is available and fits, a Symbols toggle with the symbol-level call graph. Interactions: click node for sidebar with imports/dependents/symbols list; right-click node to highlight its blast radius (reverse-transitive closure); live search; layout switcher (Dagre / force / concentric / breadth-first / grid / circle); PNG export. Use this when the user asks for a visual/interactive view, wants to explore visually, or needs a shareable diagram.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"mode": {
"type": "string",
"enum": [
"mermaid",
"interactive"
],
"description": "\"mermaid\" (default — text diagram) or \"interactive\" (browser-based explorer)."
},
"open": {
"type": "boolean",
"description": "In interactive mode, whether to auto-open the browser. Default true. Set false to just get the file path (useful in headless environments)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_healthCheck the health of all infrastructure: Docker, Qdrant container, Ollama, and embedding model. Use this to diagnose setup issues.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
} | — | — | |
codebase_impactImpact Analysis — return the BLAST RADIUS for a file or symbol. Lists every file (and, where helpful, function) that could break if you change the target. Polymorphic on target: a path-like string ('src/foo.ts') triggers file-mode; a name-like string ('validateUser') triggers symbol-mode. Use this BEFORE refactoring, renaming, or deleting code to know what depends on it.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"target": {
"type": "string",
"description": "Target file path (relative) OR symbol name."
},
"depth": {
"type": "number",
"description": "How many hops back to walk (default 3, max 10)."
}
},
"required": [
"target"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_indexStart indexing a codebase in the background. Returns immediately. Call codebase_status to poll progress until 100%. Do NOT search until indexing is complete. If already indexing, returns current progress.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory. If omitted, uses the current working directory."
},
"extraExtensions": {
"type": "string",
"description": "Comma-separated list of additional file extensions to index beyond the built-in set (e.g. '.tpl,.blade,.hbs'). Useful for projects with non-standard file extensions. Can also be set globally via EXTRA_EXTENSIONS env var."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_list_projectsList all projects that have been indexed (have collections in Qdrant).Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
} | — | — | |
codebase_removeRemove a project's codebase index entirely from the vector database. Safely stops the file watcher, cancels any in-progress indexing/update (with drain), and waits for any in-flight graph build before deleting.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"required": [
"projectPath"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_searchSemantic search across an indexed codebase. Only use after codebase_index is complete (check codebase_status first). Returns relevant code chunks matching a natural language query.Input schema{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural language search query (e.g. 'authentication middleware', 'database connection setup')."
},
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 50,
"description": "Maximum number of results to return. Default: 10 (override globally via SEARCH_DEFAULT_LIMIT env var)."
},
"fileFilter": {
"type": "string",
"description": "Filter results to a specific file path (relative)."
},
"languageFilter": {
"type": "string",
"description": "Filter results to a specific language (e.g. 'typescript', 'python')."
},
"minScore": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Minimum RRF score threshold (0-1). Results below this are filtered out. Default: 0.10 (override globally via SEARCH_MIN_SCORE env var). Set to 0 to disable filtering."
},
"includeLinked": {
"type": "boolean",
"description": "When true, also search across linked projects defined in .socraticode.json or SOCRATICODE_LINKED_PROJECTS env var. Results include a project label showing which project each result came from. Default: false."
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_statusCheck index status: chunk count, indexing progress (%), last completed operation, file watcher state. Call after codebase_index to poll until 100% complete.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_stopGracefully stop an in-progress indexing operation. The current batch will finish and checkpoint, preserving all progress. Re-run codebase_index to resume from where it left off.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory. If omitted, uses the current working directory."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_symbol360° view of a symbol: definition, kind, callers, callees, confidence levels. Use to understand a function or class before changing it.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"name": {
"type": "string",
"description": "Symbol name (e.g. 'validateUser')."
},
"file": {
"type": "string",
"description": "Optional file hint to disambiguate when the name is not unique."
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_symbolsList symbols in a file, or search by name across the project. Use to discover what exists before drilling into a single symbol with codebase_symbol.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"file": {
"type": "string",
"description": "Relative file path — list all symbols in this file."
},
"query": {
"type": "string",
"description": "Substring to match against symbol names project-wide."
},
"limit": {
"type": "number",
"description": "Maximum results (default 200)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_updateIncrementally update an existing codebase index. Only re-indexes changed files. Runs synchronously. Usually not needed if file watcher is active.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"extraExtensions": {
"type": "string",
"description": "Comma-separated list of additional file extensions to index (e.g. '.tpl,.blade')."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — | |
codebase_watchStart/stop watching a project directory for file changes and automatically update the index. When starting, first runs an incremental update to catch any changes made since the last session, then keeps the index up to date via debounced file system watching.Input schema{
"type": "object",
"properties": {
"projectPath": {
"type": "string",
"description": "Absolute path to the project directory."
},
"action": {
"type": "string",
"enum": [
"start",
"stop",
"status"
],
"description": "start/stop watching, or get status of watchers."
}
},
"required": [
"action"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — |
Resources 0
- None observed.
Resource templates 0
- None observed.
Prompts 0
- None observed.
Remote endpoints
| Endpoint | Transport | Authentication | Health | Observed |
|---|---|---|---|---|
| No verified remote endpoint is linked. | ||||
SocratiCode MCP Server questions
How do I install SocratiCode MCP Server?
Install the selected package version with: npm install --save-exact socraticode@1.12.0
What tools does SocratiCode MCP Server provide?
SocratiCode MCP Server exposed 25 tools during independent protocol observation, including codebase_about, codebase_context, codebase_context_index, codebase_context_remove, codebase_context_search, codebase_flow, codebase_graph_build, codebase_graph_circular, and others.
Is SocratiCode MCP Server secure?
The selected current version does not yet have completed public verification. Unknown does not mean clean or vulnerable.
Explore related MCP server guides
Curated product and capability guides containing this catalog record.