KnowledgeGraph

KnowledgeGraph MCP

Install

MCP endpoint

https://jacksonl.com/kg/mcp

Use server name knowledge_graph.

Auth options

OAuth

Preferred. Add the MCP server without headers, then complete the browser sign-in your agent opens.

API key

Fallback for clients that cannot complete OAuth.

Authorization: Bearer kg_your_api_key

Custom instructions

Copy into your agent
Before answering substantive questions, search the MCP 'knowledge_graph memory for relevant prior observations using exact identifiers and key terms from the user request. Prefer doing this early, before public docs, web search, or general model memory.

If MCP memory conflicts with current repo evidence or public docs, call out the conflict plainly.

Prefer current repo evidence for code behavior, prefer MCP memory for project-specific prior decisions and corrections, and use public docs for external API/platform facts unless project-specific context intentionally overrides them.

At the end of substantive repo/debugging/implementation turns, evaluate whether the work produced reusable project-specific knowledge worth saving to 'knowledge_graph. Before the first ingest/ update in a session, read the knowledgegraph authoring guide if available. Ingest only compact, evidence-backed observations that would help future searches: root causes, fixes, surprising behavior, conventions, user corrections/preferences, commands that worked, environment facts, or important "do not do X" lessons.

Before ingesting, search knowledge_graph for overlapping observations. Update an existing stale/ wrong sentence when appropriate; otherwise add new observations with ingest_sentences, batching several related observations into a single call. Do not ingest guesses, tentative hypotheses, one-off status updates, broad summaries, obvious facts, secrets, credentials, or facts not verified by current evidence. Phrase each observation as a dense declarative sentence with exact identifiers, symptoms, causes, file/class/method names, commands, errors, and alternate user terms co-located.

If the finding is uncertain but potentially useful, do not ingest it yet; mention the uncertainty in the chat instead or wait until it is verified.

Seed from existing memory

Run once after restart

After restarting your harness so knowledge_graph is connected, paste this prompt once to migrate your agent's existing memory into the graph.

Seed knowledge_graph from your existing memory. First call get_authoring_guide and follow it before writing anything.

Then review all of your native/built-in memory — and, if useful, this conversation's history — and convert every reusable, evidence-backed fact into compact, KG-optimized observation sentences as the guide describes: dense declarative text with exact identifiers, symptoms, causes, file/class/method names, commands, errors, and alternate terms co-located.

Before adding, search knowledge_graph for each fact and skip anything already stored. Add the rest in batched ingest_sentences calls (many sentences per call). Skip guesses, tentative hypotheses, one-off status, broad summaries, obvious facts, secrets, credentials, and anything not verified by current evidence.

When finished, report how many observations you added and list any you intentionally skipped and why.

Agent guides

OpenAI Codex
codex mcp add knowledge_graph --url https://jacksonl.com/kg/mcp
codex mcp login knowledge_graph

Instructions: ~/.codex/AGENTS.md globally, or AGENTS.md in a repository.

Claude Code
claude mcp add \
  --transport http \
  knowledge_graph \
  https://jacksonl.com/kg/mcp

/mcp

Instructions: ~/.claude/CLAUDE.md globally, CLAUDE.md in a repository, or a nested CLAUDE.md.

OpenCode
opencode mcp add
# name: knowledge_graph
# type: remote
# url: https://jacksonl.com/kg/mcp
opencode mcp auth knowledge_graph

Instructions: project AGENTS.md or global ~/.config/opencode/AGENTS.md.

GitHub Copilot
copilot mcp add knowledge_graph \
  --type http \
  --url https://jacksonl.com/kg/mcp \
  --tools "*"

VS Code: use MCP: Add Server. Instructions: repository .github/copilot-instructions.md or AGENTS.md; Copilot CLI local instructions use $HOME/.copilot/copilot-instructions.md.