Gctrl
Governed graph-native agent memory: knowledge extraction, fusion, hybrid RAG, scoped access tokens.
Connector by GCTRL-TECH · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/gctrl-tech-gctrl
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 19 read · 5 write · 0 delete · 10 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 34
Read from the source code; the running server may list different tools.
Read 19 · Look things up without changing anything.
gctrl_extractgctrl_find_filegctrl_get_dossiergctrl_get_entitygctrl_get_neighborsgctrl_get_sync_statusgctrl_get_user_profilegctrl_list_conflictsgctrl_list_extractionsgctrl_list_graphsgctrl_list_ontologiesgctrl_memory_health
Show 7 more tools
gctrl_querygctrl_schemagctrl_search_chunksgctrl_search_entitiesgctrl_shortest_pathgctrl_wiki_graphgctrl_wiki_page
Write 5 · Create, change, send or run things.
gctrl_fusegctrl_pin_dossiergctrl_run_maintenancegctrl_set_privacy_modegctrl_store
Not yet classified 10 · We could not tell from the name and description.
gctrl_code_architecturegctrl_code_impactgctrl_code_indexgctrl_code_symbolgctrl_code_tracegctrl_detect_communitiesgctrl_distillgctrl_ingest_filegctrl_ingest_repogctrl_memory_feedback
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GCTRL_API_TOKEN
Other settings (environment variables or headers).
GCTRL_API_URLGCTRL_GATEWAY_URL
Network hosts it talks to 2
gctrl.tech· found in codegithub.com· found in code
Files it touches
- Any path the agent passes to its tools
Tools (34)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
gctrl_code_architectureCodebase KB: one-call repo overview - languages, packages, symbol counts, hotspots, dead-code candidates.
gctrl_code_impactCodebase KB: what breaks if these files/symbols change - affected callers grouped by file + risk. Use BEFORE refactors.
gctrl_code_indexIndex a local code repository into a GCTRL Codebase KB (compilation of type CODE): walks the repo (.gitignore-aware), parses Python/TypeScript/JavaScript/Rust with tree-sitter, uploads symbols + CONTAINS/IMPORTS/CALLS/INHERITS edges + one chunk per symbol. Incremental: only files whose content hash changed since the last run are uploaded. Omit compilationId to use the session default (GCTRL_CODE_COMPILATION_ID) or to create a new CODE compilation named after the repo (in GCTRL_CODE_FOLDER when set). Afterwards use gctrl_code_symbol / gctrl_code_trace / gctrl_code_impact / gctrl_code_architectu…
gctrl_code_symbolCodebase KB: find code symbols (functions, classes, methods, files) by name/path substring - file, line range, signature, caller/callee counts. Start here for "where is X defined".
gctrl_code_traceCodebase KB: follow CALLS edges from an exact symbol name. direction callers|callees|both, depth 1-5.
gctrl_detect_communitiesRun community detection + centrality on a graph: clusters related entities (Louvain), flags the most-central "god nodes", and tags every node with its community/centrality. Returns the cluster summary. Owner action; respects KB-scoped tokens.
gctrl_distillDistill a WIKI compilation into human-readable wiki pages — one markdown page per important entity, grounded on the source RAW graph and its text chunks, with [[wikilinks]] between related entities and a Sources section. Returns how many pages were written.
gctrl_extractExtract structured knowledge (entities, relations) from text. Creates a knowledge graph in Neo4j and vector embeddings in Qdrant. Use this to ingest new information into Ground Control. Specify a compilationId to add the results to a specific knowledge graph (e.g. an agent's dedicated graph), and a sourceRef so the result stays traceable to its origin.
gctrl_find_fileFind files by name/path across connected sources (Google Drive, SharePoint) — including UNSUPPORTED files like CAD drawings (.dwg/.step), images and archives indexed as metadata. Fuzzy-ranked. Each hit includes path, size, modified/last-seen times, source, and up to 3 related parsed sibling documents from the same folder, so you can answer "where is file X, when was it seen last, and what project is it related to".
gctrl_fuseMerge knowledge graphs (or extraction jobs) into a NEW unified knowledge graph. Uses entity matching to find duplicates across sources and creates a consolidated graph. A KB-scoped token may merge the knowledge bases it is granted; the result is granted onto that token automatically. ALWAYS pass folderPath so the result is filed where it belongs.
gctrl_get_dossierRead the AUTHORITATIVE entity dossier (the HOT memory tier) for a named entity: a compiled summary, key facts (with confidence), origin files and a timeline. This is the highest-trust source — when a dossier exists it directly answers "who/what is X" and "where does X come from", with no hedging. Built on-the-fly if missing.
gctrl_get_entityRead one entity: its type, connections (up to 20 relation strings), and full provenance — origin file, sourceRef, extraction job + timestamp. Use this to answer "where does X come from / which file / what is the source of X". Prefer gctrl_get_dossier for a compiled authoritative summary.
gctrl_get_neighborsList entities within N hops of a node — dependency tracing across the knowledge graph (great for code graphs: "what does X touch?"). Clearance-filtered: only nodes you are cleared for are returned.
gctrl_get_sync_statusSummarize connector sync health: per connector (Google Drive / SharePoint) the last sync time and live job counts by status, plus the last 5 failed source files with their errors. Use to answer "is my Drive sync working / what failed last".
gctrl_get_user_profileRead the owner personalization profile (opt-in facts + summary) so you can tailor answers to who is asking. Owner-level.
Show 19 more tools
gctrl_ingest_fileIngest a PDF, DOCX, PPTX, image (PNG/JPG/WEBP/TIFF/BMP/GIF — transcribed by the vision model when the runtime can see, OCR otherwise), scanned PDF, or other binary file into the knowledge graph. Use this whenever the user drops, mentions, or references a file (not raw text) that should become knowledge — reads the file from local disk, uploads it, and starts extraction. For plain text, use gctrl_extract/gctrl_store instead.
gctrl_ingest_repoLEGACY (Python-only, structure only). Prefer gctrl_code_index for a real Codebase KB. Ingest a (Python) code repository into the knowledge graph: parses files into File/Class/Function/Module entities + CONTAINS/IMPORTS/CALLS/INHERITS edges (fully local, no LLM). Classification flows in like any other knowledge. Pass files as [{path, content}].
gctrl_list_conflictsList open classification conflicts — entities whose sources disagree on sensitivity (≥2 distinct clearance ranks). Useful for governance / compliance review.
gctrl_list_extractionsList recent knowledge extraction jobs with their status, entity counts, and source info.
gctrl_list_graphsList all knowledge graph compilations available in Ground Control. Shows name, entity count, relation count, and classification level.
gctrl_list_ontologiesList all ontologies available in Ground Control. Ontologies define entity types and matching rules for knowledge extraction.
gctrl_memory_feedbackReinforce or distrust a memory: vote 'up' raises an entity dossier's trust; 'down' sets it to 0 and, if you pass a fact triple (compilationId+head+relType+tail), deletes that wrong edge and remembers the correction so it never returns. Owner-level.
gctrl_memory_healthRead the memory snapshot: coverage, store sizes (entities/edges/chunks/dossiers/wiki), heat + trust distribution, and the last maintenance cycle. Owner-level.
gctrl_pin_dossierPin (or unpin) an entity dossier so it stays in HOT memory and is always injected into answers. Owner-level memory curation — denied for KB-scoped tokens.
gctrl_queryAsk a natural-language question — GCTRL blends ALL memory layers automatically (HOT dossiers > graph facts > warm chunks) and returns a grounded answer with sources + confidence. Prefer this for open questions; then persist any new conclusion with gctrl_store.
gctrl_run_maintenanceRun one memory governance cycle now (decay → dedup → promote hot → evict stale). Owner-level.
gctrl_schemaGet the schema of the knowledge graph — available entity types, relationship types, and property keys. Useful for understanding what data is stored.
gctrl_search_chunksRetrieve source text passages (warm vector + keyword) for a question — the raw evidence layer. Limit is fixed at 5 passages. Use this to back up an answer with citations; prefer gctrl_query for a composed blended answer.
gctrl_search_entitiesSearch for specific entities in the knowledge graph by name or type. Returns matching entities with their properties and relationships.
gctrl_set_privacy_modeRaise a knowledge graph's privacy for cloud LLMs during setup: 'cloaked' (pseudonymize entities/PII before a cloud model sees them) or 'local_only' (never send it to a cloud model). Can only INCREASE privacy — loosening it back to 'open' needs the Settings UI. Never call this 'encryption'.
gctrl_shortest_pathFind the shortest path between two entities (how is A connected to B / does X depend on Y). Clearance-aware: a path is only returned if every node on it is one you are cleared to see.
gctrl_storePersist knowledge into GCTRL — call this when the user asks you to remember something or confirms your proposal (never unasked after a task: unverified agent notes get quoted back later as facts). Extracts entities + builds graph from the text, like saving notes but structured. IMPORTANT: always pass a compilationId for your assigned knowledge base (find it via gctrl_list_graphs) so nothing is orphaned, and a sourceRef (or at least a title) so the stored facts keep their origin.
gctrl_wiki_graphGet a WIKI compilation as a navigable graph: pages are nodes, [[wikilinks]] are edges. Clearance-filtered (pages above your clearance, and their links, are hidden). Useful for canvas/visual clients.
gctrl_wiki_pageRead distilled wiki pages from a WIKI compilation. Pass a slug to fetch one full page (markdown body + citations); omit the slug to list all pages (optionally filtered by query).
Compare and alternatives
Featured in
Signals
- Stars
- 7
- Forks
- 1
- Open issues
- 0
- Last commit (this folder)
- Oct 23, 2026 (5 days ago)
- Last release
- Aug 25, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.GCTRL-TECH/gctrl- Version
- 1.2.0
- Auth
- API key
- Packages
- npm gctrl-mcp
- License
- AGPL-3.0
- Repository
- github.com/GCTRL-TECH/platform
- Website
- gctrl.tech
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Gctrl MCP server. Agent Mart. https://agentmart.dev/connectors/gctrl-tech-gctrl (last updated 2026-10-24)