io.github.GCTRL-TECH/gctrl
NPM · GCTRL-MCP · SCANNED SEP 20
Governed graph-native agent memory: knowledge extraction, fusion, hybrid RAG, scoped access tokens.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 32 of 100 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (AGPL-3.0-or-later).Pass
- Actively maintained (last published 25 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability77
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 6480 tokens (~108/item across 60 items; 60 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management97
- Stability observed for 29 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage94
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 81% of tool parameters carry a description.Partial
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "gctrl_fuse" implies "merge" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 61 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.GCTRL-TECH/gctrl MCP server?
io.github.GCTRL-TECH/gctrl runs locally as an npm package, launched with npx -y gctrl-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · gctrl-mcp
claude mcp add gctrl-tech-gctrl -- npx -y gctrl-mcp
{
"mcpServers": {
"gctrl-tech-gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
]
}
}
} {
"servers": {
"gctrl-tech-gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
]
}
}
} codex mcp add gctrl-tech-gctrl -- npx -y gctrl-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"gctrl-tech-gctrl": {
"type": "local",
"command": [
"npx",
"-y",
"gctrl-mcp"
],
"enabled": true
}
}
} openclaw mcp add gctrl-tech-gctrl --command npx --arg -y --arg gctrl-mcp
mcp_servers:
gctrl-tech-gctrl:
command: "npx"
args: ["-y", "gctrl-mcp"] {
"McpServers": {
"gctrl-tech-gctrl": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"gctrl-mcp"
]
}
}
} assistant mcp add gctrl-tech-gctrl -t stdio -c npx -a -y gctrl-mcp
{
"mcpServers": {
"gctrl-tech-gctrl": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → 0.83 functional
- 15 Sept 26 +1
- Stability: 0.97 → pass security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +1
- Security disclosure: unverified → pass ▲ functional
- 11 Sept 26 0
- Security disclosure: pass → unverified ▼ functional
- 9 Sept 26 −2
- Security disclosure: unverified → pass ▲ functional
- Stability: pass → 0.80 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/gctrl-mcp@1.2.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 100 packages
| Packages resolved | 100 |
|---|---|
| Stale | 31 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
borghive_detect_communities ~103
[DEPRECATED — use 'gctrl_detect_communities' instead, alias will be removed in v2] Run 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The compilation (graph) ID to analyse |
No output schema declared.
No examples provided.
borghive_distill ~148
[DEPRECATED — use 'gctrl_distill' instead, alias will be removed in v2] Distill 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The WIKI compilation ID to distill into wiki pages. Must be a compilation of type WIKI (created with a wikiSourceCompilationId). |
| limit | number | – | Max number of entity pages to generate (default 15). Higher = slower (one LLM call per entity). |
No output schema declared.
No examples provided.
borghive_extract ~178
[DEPRECATED — use 'gctrl_extract' instead, alias will be removed in v2] Extract 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).
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Optional: target knowledge graph compilation ID. The extracted job will be auto-linked to this compilation. Use gctrl_list_graphs to find IDs. |
| discoveryMode | string | – | strict = only ontology types, discover = find all types and extend ontology |
| ontologyId | string | – | Optional ontology ID to guide entity type extraction |
| text | string | yes | The text content to extract knowledge from |
No output schema declared.
No examples provided.
borghive_fuse ~96
[DEPRECATED — use 'gctrl_fuse' instead, alias will be removed in v2] Merge multiple extraction jobs into a unified knowledge graph. Uses entity matching to find duplicates across sources and creates a consolidated graph.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Optional description |
| name | string | yes | Name for the new fused knowledge graph |
| sourceJobIds | array | yes | Array of KEX job IDs to merge |
No output schema declared.
No examples provided.
borghive_get_dossier ~137
[DEPRECATED — use 'gctrl_get_dossier' instead, alias will be removed in v2] Read 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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The entity name to fetch the dossier for (e.g. "Fabio", "Ground Control") |
No output schema declared.
No examples provided.
borghive_get_entity ~113
[DEPRECATED — use 'gctrl_get_entity' instead, alias will be removed in v2] Read 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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Entity name to look up (exact or close match) |
No output schema declared.
No examples provided.
borghive_get_neighbors ~104
[DEPRECATED — use 'gctrl_get_neighbors' instead, alias will be removed in v2] List 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.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | – | Hops to expand (1-3, default 1) |
| name | string | yes | Entity name to expand from |
No output schema declared.
No examples provided.
borghive_get_user_profile ~59
[DEPRECATED — use 'gctrl_get_user_profile' instead, alias will be removed in v2] Read the owner personalization profile (opt-in facts + summary) so you can tailor answers to who is asking. Owner-level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_ingest_repo ~177
[DEPRECATED — use 'gctrl_ingest_repo' instead, alias will be removed in v2] LEGACY (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}].
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLevelId | string | – | Optional classification level UUID for the ingested code |
| files | array | yes | Repo files as {path, content} (Python .py files are parsed; others skipped) |
| repoName | string | – | Optional repo name (provenance origin) |
No output schema declared.
No examples provided.
borghive_list_conflicts ~59
[DEPRECATED — use 'gctrl_list_conflicts' instead, alias will be removed in v2] List open classification conflicts — entities whose sources disagree on sensitivity (≥2 distinct clearance ranks). Useful for governance / compliance review.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_list_extractions ~61
[DEPRECATED — use 'gctrl_list_extractions' instead, alias will be removed in v2] List recent knowledge extraction jobs with their status, entity counts, and source info.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Maximum jobs to return |
No output schema declared.
No examples provided.
borghive_list_graphs ~58
[DEPRECATED — use 'gctrl_list_graphs' instead, alias will be removed in v2] List all knowledge graph compilations available in Ground Control. Shows name, entity count, relation count, and classification level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_list_ontologies ~57
[DEPRECATED — use 'gctrl_list_ontologies' instead, alias will be removed in v2] List all ontologies available in Ground Control. Ontologies define entity types and matching rules for knowledge extraction.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_memory_feedback ~165
[DEPRECATED — use 'gctrl_memory_feedback' instead, alias will be removed in v2] Reinforce 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | For a targeted 👎 fact correction |
| entity | string | yes | Entity whose dossier the feedback targets |
| head | string | – | – |
| relType | string | – | – |
| tail | string | – | – |
| vote | string | yes | 'up' to confirm/reinforce, 'down' to distrust |
No output schema declared.
No examples provided.
borghive_memory_health ~65
[DEPRECATED — use 'gctrl_memory_health' instead, alias will be removed in v2] Read the memory snapshot: coverage, store sizes (entities/edges/chunks/dossiers/wiki), heat + trust distribution, and the last maintenance cycle. Owner-level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_pin_dossier ~101
[DEPRECATED — use 'gctrl_pin_dossier' instead, alias will be removed in v2] Pin (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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Entity name to pin/unpin |
| pinned | boolean | – | true=pin, false=unpin, omit=toggle |
No output schema declared.
No examples provided.
borghive_query ~116
[DEPRECATED — use 'gctrl_query' instead, alias will be removed in v2] Ask 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Optional: query a specific knowledge graph compilation. Omit to search all graphs. |
| question | string | yes | Natural language question about the knowledge graph |
No output schema declared.
No examples provided.
borghive_run_maintenance ~57
[DEPRECATED — use 'gctrl_run_maintenance' instead, alias will be removed in v2] Run one memory governance cycle now (decay → dedup → promote hot → evict stale). Owner-level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_schema ~57
[DEPRECATED — use 'gctrl_schema' instead, alias will be removed in v2] Get the schema of the knowledge graph — available entity types, relationship types, and property keys. Useful for understanding what data is stored.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
borghive_search_chunks ~113
[DEPRECATED — use 'gctrl_search_chunks' instead, alias will be removed in v2] Retrieve 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Optional: scope to a specific knowledge graph compilation |
| query | string | yes | The question or topic to retrieve source text passages for |
No output schema declared.
No examples provided.
borghive_search_entities ~105
[DEPRECATED — use 'gctrl_search_entities' instead, alias will be removed in v2] Search for specific entities in the knowledge graph by name or type. Returns matching entities with their properties and relationships.
| Name | Type | Req | Description |
|---|---|---|---|
| entityType | string | – | Filter by entity type label (e.g. "company", "person", "technology") |
| limit | number | – | Maximum results to return |
| query | string | yes | Search term (entity name or partial match) |
No output schema declared.
No examples provided.
borghive_set_privacy_mode ~176
[DEPRECATED — use 'gctrl_set_privacy_mode' instead, alias will be removed in v2] Raise 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'.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The knowledge graph to make more private. |
| mode | string | yes | 'cloaked' = entities/PII are pseudonymized before any cloud model sees them (recommended when you are a cloud model); 'local_only' = this graph is never sent to a cloud model. |
No output schema declared.
No examples provided.
borghive_shortest_path ~96
[DEPRECATED — use 'gctrl_shortest_path' instead, alias will be removed in v2] Find 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.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Start entity name |
| to | string | yes | End entity name |
No output schema declared.
No examples provided.
borghive_store ~181
[DEPRECATED — use 'gctrl_store' instead, alias will be removed in v2] WRITE your conclusions back into GCTRL — call this after ANY substantive task so your memory compounds across sessions (this is the point of GCTRL). 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Target knowledge graph compilation ID. RECOMMENDED: always specify this to store into the correct agent graph. Use gctrl_list_graphs to find IDs. |
| ontologyId | string | – | Optional ontology to guide extraction |
| text | string | yes | Text content to store as knowledge |
| title | string | – | Optional title/label for this knowledge |
No output schema declared.
No examples provided.
borghive_wiki_graph ~93
[DEPRECATED — use 'gctrl_wiki_graph' instead, alias will be removed in v2] Get 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The WIKI compilation ID |
No output schema declared.
No examples provided.
borghive_wiki_page ~142
[DEPRECATED — use 'gctrl_wiki_page' instead, alias will be removed in v2] Read 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).
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The WIKI compilation ID. |
| query | string | – | Optional: when no slug is given, filter the listed pages whose title contains this text. |
| slug | string | – | Slug of a specific page to fetch (e.g. "fabio-chiaramonte"). Omit to list all pages. |
No output schema declared.
No examples provided.
gctrl_code_architecture ~41
Codebase KB: one-call repo overview - languages, packages, symbol counts, hotspots, dead-code candidates.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | – |
No output schema declared.
No examples provided.
gctrl_code_impact ~69
Codebase KB: what breaks if these files/symbols change - affected callers grouped by file + risk. Use BEFORE refactors.
| Name | Type | Req | Description |
|---|---|---|---|
| changedFiles | array | – | – |
| changedSymbols | array | – | – |
| compilationId | string | – | – |
| depth | number | – | – |
No output schema declared.
No examples provided.
gctrl_code_index ~218
Index 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_architecture.
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLevelId | string | – | – |
| compilationId | string | – | Target CODE compilation. Omit to use the session default or create one. |
| full | boolean | – | Force re-upload of every file (default: incremental) |
| repoPath | string | yes | Absolute path of the repository root on this machine |
No output schema declared.
No examples provided.
gctrl_code_symbol ~88
Codebase 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".
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | – |
| limit | number | – | – |
| offset | number | – | – |
| query | string | yes | – |
| types | array | – | – |
No output schema declared.
No examples provided.
gctrl_code_trace ~67
Codebase KB: follow CALLS edges from an exact symbol name. direction callers|callees|both, depth 1-5.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | – |
| depth | number | – | – |
| direction | string | – | – |
| symbol | string | yes | – |
No output schema declared.
No examples provided.
gctrl_detect_communities ~79
Run 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The compilation (graph) ID to analyse |
No output schema declared.
No examples provided.
gctrl_distill ~126
Distill 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | yes | The WIKI compilation ID to distill into wiki pages. Must be a compilation of type WIKI (created with a wikiSourceCompilationId). |
| limit | number | – | Max number of entity pages to generate (default 15). Higher = slower (one LLM call per entity). |
No output schema declared.
No examples provided.
gctrl_extract ~157
Extract 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).
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Optional: target knowledge graph compilation ID. The extracted job will be auto-linked to this compilation. Use gctrl_list_graphs to find IDs. |
| discoveryMode | string | – | strict = only ontology types, discover = find all types and extend ontology |
| ontologyId | string | – | Optional ontology ID to guide entity type extraction |
| text | string | yes | The text content to extract knowledge from |
No output schema declared.
No examples provided.
gctrl_find_file ~156
Find 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".
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Maximum hits to return (default 5, max 25) |
| query | string | yes | File name or path fragment to search for (fuzzy), e.g. "rim cad" or "felge.dwg" |
No output schema declared.
No examples provided.
gctrl_fuse ~74
Merge multiple extraction jobs into a unified knowledge graph. Uses entity matching to find duplicates across sources and creates a consolidated graph.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Optional description |
| name | string | yes | Name for the new fused knowledge graph |
| sourceJobIds | array | yes | Array of KEX job IDs to merge |
No output schema declared.
No examples provided.
gctrl_get_dossier ~114
Read 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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The entity name to fetch the dossier for (e.g. "Fabio", "Ground Control") |
No output schema declared.
No examples provided.
gctrl_get_entity ~91
Read 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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Entity name to look up (exact or close match) |
No output schema declared.
No examples provided.
gctrl_get_neighbors ~82
List 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.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | – | Hops to expand (1-3, default 1) |
| name | string | yes | Entity name to expand from |
No output schema declared.
No examples provided.
gctrl_get_sync_status ~64
Summarize 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".
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_get_user_profile ~36
Read the owner personalization profile (opt-in facts + summary) so you can tailor answers to who is asking. Owner-level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_ingest_file ~149
Ingest a PDF, DOCX, 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | Optional: target knowledge graph compilation ID. Omit to fall back to your default knowledge base. |
| ontologyId | string | – | Optional ontology ID to guide entity type extraction |
| path | string | yes | Absolute (or cwd-relative) path to the local file to ingest, e.g. a PDF or DOCX |
No output schema declared.
No examples provided.
gctrl_ingest_repo ~154
LEGACY (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}].
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLevelId | string | – | Optional classification level UUID for the ingested code |
| files | array | yes | Repo files as {path, content} (Python .py files are parsed; others skipped) |
| repoName | string | – | Optional repo name (provenance origin) |
No output schema declared.
No examples provided.
gctrl_list_conflicts ~36
List open classification conflicts — entities whose sources disagree on sensitivity (≥2 distinct clearance ranks). Useful for governance / compliance review.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_list_extractions ~38
List recent knowledge extraction jobs with their status, entity counts, and source info.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Maximum jobs to return |
No output schema declared.
No examples provided.
gctrl_list_graphs ~35
List all knowledge graph compilations available in Ground Control. Shows name, entity count, relation count, and classification level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_list_ontologies ~33
List all ontologies available in Ground Control. Ontologies define entity types and matching rules for knowledge extraction.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_memory_feedback ~143
Reinforce 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.
| Name | Type | Req | Description |
|---|---|---|---|
| compilationId | string | – | For a targeted 👎 fact correction |
| entity | string | yes | Entity whose dossier the feedback targets |
| head | string | – | – |
| relType | string | – | – |
| tail | string | – | – |
| vote | string | yes | 'up' to confirm/reinforce, 'down' to distrust |
No output schema declared.
No examples provided.
gctrl_memory_health ~43
Read the memory snapshot: coverage, store sizes (entities/edges/chunks/dossiers/wiki), heat + trust distribution, and the last maintenance cycle. Owner-level.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
gctrl_pin_dossier ~78
Pin (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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Entity name to pin/unpin |
| pinned | boolean | – | true=pin, false=unpin, omit=toggle |
No output schema declared.
No examples provided.
What is the io.github.GCTRL-TECH/gctrl MCP server?
io.github.GCTRL-TECH/gctrl is an MCP server listed in the public MCP registry as io.github.GCTRL-TECH/gctrl. Governed graph-native agent memory: knowledge extraction, fusion, hybrid RAG, scoped access tokens. This page covers its npm package (gctrl-mcp).
Is the io.github.GCTRL-TECH/gctrl MCP server safe to use?
io.github.GCTRL-TECH/gctrl scores 82 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.GCTRL-TECH/gctrl MCP server expose?
io.github.GCTRL-TECH/gctrl exposes 60 tools: gctrl_extract, borghive_extract, gctrl_query, borghive_query, gctrl_search_entities, and 55 more. Their descriptions and schemas cost roughly 5,901 tokens of context every time the server is loaded.
Is the io.github.GCTRL-TECH/gctrl MCP server still maintained?
io.github.GCTRL-TECH/gctrl is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.GCTRL-TECH/gctrl MCP server under?
io.github.GCTRL-TECH/gctrl declares the AGPL-3.0-or-later licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.