Knowing

Name: Knowing
Author: blackwell-systems

by blackwell-systemscommunityv0.15.1

MCP server that indexes a code repository into a content-addressed graph, then returns ranked code context for tasks such as impact analysis, test selection, and symbol lookup. It also supports cryptographic proofs and offline verification of code relationships from graph snapshots tied to git commits.

From the registry: Content-addressed code graph with 22 MCP tools for AI agents.

GitHub Repository

Install & configure

Prerequisites

required
Install knowing
Install the knowing CLI/MCP server. The README presents Homebrew as the primary install method and also lists npm, pip, and go install alternatives.
```
$ brew install blackwell-systems/tap/knowing
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `knowing` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install knowing** — Install the knowing CLI/MCP server. The README presents Homebrew as the primary install method and also lists npm, pip, and go install alternatives. Run: `brew install blackwell-systems/tap/knowing`

Canonical MCP server config (stdio transport):
- command: `knowing`
- args: ["mcp","--watch"]

Note: Preferred MCP setup uses stdio with `knowing mcp --watch`. The server auto-indexes the current git repository on first launch. It also auto-downloads a local embedding model (~30MB) on first use; no API keys are required. The README also documents an HTTP mode via `knowing serve -addr :8100 .`, but stdio is the recommended/default path. To disable embeddings, add `--no-embeddings` to the stdio args.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Preferred MCP setup uses stdio with `knowing mcp --watch`. The server auto-indexes the current git repository on first launch. It also auto-downloads a local embedding model (~30MB) on first use; no API keys are required. The README also documents an HTTP mode via `knowing serve -addr :8100 .`, but stdio is the recommended/default path. To disable embeddings, add `--no-embeddings` to the stdio args.

Tools (8)

context_for_task

Returns ranked relevant code symbols for a task within a token budget.

blast_radius

Shows what may break if a function or symbol changes, across callers, tests, routes, and repos.

test_scope

Identifies which tests should run for a changed set of files or symbols.

explain_symbol

Explains why a symbol ranked where it did for a given task.

prove

Generates a cryptographic Merkle proof that a relationship existed.

verify

Verifies a proof offline without needing the database.

fsck

Checks graph integrity and verifies the graph for errors.

stale

Checks whether the graph is stale relative to recent code changes.

Packages

@blackwell-systems/knowing

npmv0.15.1transport: stdio

Details

Language: Go
License: MIT
Released: Jun 10, 2026
Last commit: Jun 13, 2026
Registry name: io.github.blackwell-systems/knowing

Related Servers

GitHub

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

31.4k

Gk Cli

The GitKraken MCP Server for managing repos, PRs, issues across GitHub, GitLab, Bitbucket and more.

432

Git Mcp Server

Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more.

226