io.github.GCTRL-TECH/gctrl

NPM · GCTRL-MCP · SCANNED AUG 3

Governed graph-native agent memory: knowledge extraction, fusion, hybrid RAG, scoped access tokens.

Available components

+21 this week 67 67 Trust /100

Trust breakdown (6 categories)

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 →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

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 14 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability64

AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 5677 tokens (~103/item across 55 items; 55 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 Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage98

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
94% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · gctrl-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add gctrl-tech-gctrl -- npx -y gctrl-mcp

# add to Codex CLI

codex mcp add gctrl-tech-gctrl -- npx -y gctrl-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gctrl-tech-gctrl": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gctrl-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add gctrl-tech-gctrl --command npx --arg -y --arg gctrl-mcp

# ~/.hermes/config.yaml

mcp_servers:
  gctrl-tech-gctrl:
    command: "npx"
    args: ["-y", "gctrl-mcp"]

// mcp.json

{
  "mcpServers": {
    "gctrl-tech-gctrl": {
      "command": "npx",
      "args": [
        "-y",
        "gctrl-mcp"
      ]
    }
  }
}

Changelog

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.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +45
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- First check of Schema quality: unverified functional
- Licence: AGPL-3.0-or-later functional
1 Aug 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

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 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 55 exposed · ~5,376 tokens

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.

Tool Tokens

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

borghive_ingest_repo ~156

[DEPRECATED — use 'gctrl_ingest_repo' instead, alias will be removed in v2] 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}].

Input Output Examples

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 Output Examples

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.

Input Output Examples

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 Output Examples

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 Output Examples

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.

Input Output Examples

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 Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 Output Examples

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 Output Examples

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.

Input Output Examples

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.

Input Output Examples

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'.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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_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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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".

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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 Output Examples

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 Output Examples

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.

Input Output Examples

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 ~133

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}].

Input Output Examples

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 Output Examples

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.

Input Output Examples

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 Output Examples

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 Output Examples

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.

Input Output Examples

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 Output Examples

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.

Input Output Examples

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.

gctrl_query ~95

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.

Input Output Examples

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.

gctrl_run_maintenance ~34

Run one memory governance cycle now (decay → dedup → promote hot → evict stale). Owner-level.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

gctrl_schema ~36

Get the schema of the knowledge graph — available entity types, relationship types, and property keys. Useful for understanding what data is stored.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

gctrl_search_chunks ~91

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.

Input Output Examples

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.

gctrl_search_entities ~83

Search for specific entities in the knowledge graph by name or type. Returns matching entities with their properties and relationships.

Input Output Examples

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.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug