SocratiCode MCP Server: Setup for Claude, Cursor and Other Apps

• Starts indexing a codebase for search

  Begins indexing a project in the background and returns at once. Check the status tool until it reaches 100% before searching.

  Try: “Index this codebase.”

  Runs code · codebase_index

• Shows indexing progress

  Reports chunk count, progress, the last finished operation and file watcher state.

  Try: “What is the codebase index status?”

  Read · codebase_status

• Searches the code by meaning

  Runs a semantic search over an indexed codebase from a plain-language question and returns matching code chunks.

  Try: “Where do we validate login tokens?”

  Read · codebase_search

• Refreshes the index with changed files

  Re-indexes only the files that changed, and waits until it is done.

  Try: “Update the index with my latest edits.”

  Write · codebase_update

• Keeps the index up to date as files change

  Starts or stops watching a folder, and catches up with an incremental update first when it starts.

  Try: “Watch this project and keep the index current.”

  Write · codebase_watch

• Stops indexing that is running

  Stops an index run after the current batch, keeping progress so it can resume.

  Try: “Stop the indexing for now.”

  Write · codebase_stop

• Shows what could break if you change something

  Lists the files and functions that depend on a file or symbol, so you can see the blast radius of a change.

  Try: “What breaks if I change validateUser?”

  Read · codebase_impact

• Traces what code calls from an entry point

  Without arguments, lists likely entry points. With one, returns the call tree from it.

  Try: “Trace the flow starting at main.”

  Read · codebase_flow

• Shows a function or class in full

  Gives the definition, kind, callers and callees of one symbol, with confidence levels.

  Try: “Show me everything about parseConfig.”

  Read · codebase_symbol

• Lists symbols in a file or finds them by name

  Lists the symbols in a file, or searches the project for a name.

  Try: “List the functions in src/auth.ts.”

  Read · codebase_symbols

• Builds a map of how files import each other

  Builds a dependency graph by static analysis of import and export links, in the background.

  Try: “Build the dependency graph.”

  Write · codebase_graph_build

• Shows dependency graph build progress

  Reports build progress, node and edge counts, and when the graph was last built.

  Try: “Is the dependency graph ready?”

  Read · codebase_graph_status

• Shows what a file imports and what depends on it

  Returns the imports of a file and the files that depend on it.

  Try: “What depends on src/db.ts?”

  Read · codebase_graph_query

• Summarizes the dependency graph

  Returns file and edge counts, the most connected files, orphan files and circular dependencies.

  Try: “Give me stats on the dependency graph.”

  Read · codebase_graph_stats

• Finds circular dependencies

  Lists cycles of files that import each other.

  Try: “Are there circular dependencies?”

  Read · codebase_graph_circular

• Draws the dependency graph

  Returns a Mermaid diagram as text, or writes an interactive HTML page and opens it in your browser.

  Try: “Show the dependency graph as a diagram.”

  Files · codebase_graph_visualize

• Deletes the saved dependency graph

  Removes a project's stored graph. It can be rebuilt later.

  Try: “Remove the saved graph for this project.”

  Delete · codebase_graph_remove

• Lists extra project knowledge you defined

  Lists the artifacts in the context file, such as database schemas and API specs, with their index status.

  Try: “What context artifacts does this project have?”

  Read · codebase_context

• Searches schemas, API specs and docs by meaning

  Runs a semantic search over the context artifacts, indexing them on first use.

  Try: “Which tables hold customer addresses?”

  Write · codebase_context_search

• Indexes the context artifacts

  Chunks and embeds the artifacts so they can be searched. Usually not needed because search does it.

  Try: “Index the context artifacts.”

  Write · codebase_context_index

• Deletes the indexed context artifacts

  Removes a project's indexed context artifacts from the vector database.

  Try: “Remove the context index.”

  Delete · codebase_context_remove

• Deletes a project's code index

  Removes the whole index for a project from the vector database, after stopping the watcher and any running index work. Your source files are not touched.

  Try: “Remove the index for this project.”

  Delete · codebase_remove

• Reports or cleans up stored project data

  Lists stored project identities and their resources. It only reports unless you confirm an exact identity with a fresh token.

  Try: “Show me stored projects that may be abandoned.”

  Delete · codebase_prune

• Lists indexed projects

  Lists every project that has an index in the vector database.

  Try: “Which projects are indexed?”

  Read · codebase_list_projects

• Checks Docker, Qdrant and the embedding model

  Diagnoses the supporting services the server needs.

  Try: “Why is code search not working?”

  Read · codebase_health

• Explains what SocratiCode is

  Returns an overview of the server and its tools.

  Try: “What can SocratiCode do?”

  Read · codebase_about

Watch out for

• It needs Docker and starts containers

  First use pulls images and starts Qdrant and Ollama through Docker. Make sure you are happy to run them. github.com

• Cloud embeddings send code out

  Choosing OpenAI, Google or a remote Qdrant sends code chunks to those services. Keep the default local setup for private code. github.com

• Some tools delete saved indexes

  Remove and prune tools delete stored index data, not your source files. Check the target before approving. github.com

• The graph viewer can open your browser

  The interactive mode writes an HTML page and opens it. Ask for the text diagram if you do not want that. github.com

Security advisories