Graqle — MCP server for Claude Code: code knowledge graph
Builds one knowledge graph from code and documents so the agent can answer with sources, and screens its actions against a decision gate.
claude mcp add graqle -- uvx graqleWhat Graqle does
A scan turns a repository and a folder of documents into a single graph: graq scan repo . for code, graq scan docs ./policies for policies and ADRs, graq learn knowledge for a fact you type in. Then graq run returns an answer with a confidence figure and the sources it drew on. PDF, DOCX, PPTX and XLSX files need the extra graqle[docs] package.
The Decision Assurance Gate sits in front of agent actions. It hands back one of five outcomes (EXECUTE, REPLAN, HOLD, REJECT, ESCALATE) and writes a signed, hash-chained record. The gate stays off until GRAQLE_DAG_ENABLED is set, so a plain install changes nothing. Turning it on is real work: no thresholds, salts or keys ship with the package. You supply every GRAQLE_DAG_* value, an ed25519 signing key included. Miss one and the first settings load throws a configuration error naming the field, with no fallback.
A team can share a single graph. graq mcp serve runs the server over HTTP and each session reaches it through graq mcp relay, so the session holds a small relay rather than a full copy: on a 20,000-node graph, three standalone servers measured 687 MB against 493 MB for one server plus three relays. File work stays on each user's machine, and --allowed-roots scopes what the server may touch.
What it helps with
- answer a question from code and policy with the sources attached
- merge docs, ADRs and a repository into one graph
- check an agent action before it runs and see why it was refused
- leave a signed record of every decision an auditor can verify
- share one graph across several agent sessions
Example prompts for the agent
- Wire Graqle in through
.mcp.jsonand tell me what approval a large refund needs - Scan
./policiesand the repo, then answer what the vendor data access policy says - Switch on the Decision Assurance Gate with
GRAQLE_DAG_ENABLED=1and check the verdict for this action
How to install Graqle
Platform CLI
claude mcp add graqle -- uvx graqleuvx runs the command named after the package; if the README names another one, use uvx --from graqle <command>
Platform CLI
codex mcp add graqle -- uvx graqleuvx runs the command named after the package; if the README names another one, use uvx --from graqle <command>
Config file
{
"mcpServers": {
"graqle": {
"command": "uvx",
"args": [
"graqle"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from graqle <command>
Config file
{
"servers": {
"graqle": {
"type": "stdio",
"command": "uvx",
"args": [
"graqle"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from graqle <command>
Platform CLI
gemini mcp add graqle uvx graqleuvx runs the command named after the package; if the README names another one, use uvx --from graqle <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Graqle
How do I install Graqle in Claude Code?
Run claude mcp add graqle -- uvx graqle. For PDF, DOCX, PPTX and XLSX parsing, add the graqle[docs] package as well.
What does Graqle do?
It turns code, documents and rules into one knowledge graph the agent can query, and screens its actions through the Decision Assurance Gate with a signed record for each verdict.
What is needed to enable the decision gate?
Set GRAQLE_DAG_ENABLED=1 and supply every required GRAQLE_DAG_* setting: an ed25519 key with its manifest, thresholds, a salt, the calibrator version and the rest. The package ships no values, and a missing one raises a configuration error.
