Knowerage MCP Server

Register Knowerage wherever your MCP host expects server definitions (for example some clients use `.cursor/mcp.json` or `.vscode/mcp.json`; others

Local serverstdio

What is the Knowerage MCP server?

Knowerage MCP server exists for a simple reason — assistants are far more useful when they can act on Knowerage directly instead of describing what you should do. Register Knowerage wherever your MCP host expects server definitions (for example some clients use .cursor/mcp.json or .vscode/mcp.json; others use environment variables or a UI—follow your host’s documentation). Use the same server.

Setting it up

The server ships on npm as @mtimma/knowerage, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

What the assistant can call

Once Knowerage is connected, these are the calls the assistant has available:

  • knowerage_create_or_update_doc — Create/update analysis document
  • knowerage_parse_doc_metadata — Parse and validate frontmatter
  • knowerage_reconcile_record — Reconcile one analysis record
  • knowerage_reconcile_all — Full rescan/rebuild
  • knowerage_get_file_status — Analyzed vs missing ranges
  • knowerage_list_stale — List stale/problematic records
  • knowerage_list_registry — Full registry snapshot (same shape as registry.json, sorted keys)
  • knowerage_get_tree — Tree/grouped coverage
  • registry_export_report — Export snapshot (JSON/YAML/TXT/HTML)
  • knowerage_generate_bundle — Chunked export of selected analyses (toc*.md, combined*.md, manifest.json)

Configuration and credentials

You will need 2 environment variables: KNOWERAGE_WORKSPACE_ROOT, KNOWERAGE_AUTO_FULL_RECONCILE. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Knowerage.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the knowerage mcp server does with a few real requests.

Choosing this one

This sits in the knowledge and memory group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Knowerage's toolset — knowerage_create_or_update_doc, knowerage_parse_doc_metadata, knowerage_reconcile_record and 7 more — is a fair guide to whether it matches your workflow. It is maintained by mtimma; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Knowerage's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
knowerage_create_or_update_docCreate/update analysis document
knowerage_parse_doc_metadataParse and validate frontmatter
knowerage_reconcile_recordReconcile one analysis record
knowerage_reconcile_allFull rescan/rebuild
knowerage_get_file_statusAnalyzed vs missing ranges
knowerage_list_staleList stale/problematic records
knowerage_list_registryFull registry snapshot (same shape as registry.json, sorted keys)
knowerage_get_treeTree/grouped coverage
registry_export_reportExport snapshot (JSON/YAML/TXT/HTML)
knowerage_generate_bundleChunked export of selected analyses (toc*.md, combined*.md, manifest.json)

How to install the Knowerage MCP server

{
  "mcpServers": {
    "knowerage": {
      "command": "npx",
      "args": ["@mtimma/knowerage"],
      "env": {
        "KNOWERAGE_WORKSPACE_ROOT": "${workspaceFolder}",
        "KNOWERAGE_AUTO_FULL_RECONCILE": "true"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
KNOWERAGE_WORKSPACE_ROOTConfiguration value read at startup.Optional
KNOWERAGE_AUTO_FULL_RECONCILEConfiguration value read at startup.Optional

Example prompts to try

  • Use Knowerage to knowerage create or update doc.
  • Use Knowerage to knowerage parse doc metadata.
  • Use Knowerage to knowerage reconcile record.

Frequently asked questions

It connects Knowerage to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (knowerage_create_or_update_doc, knowerage_parse_doc_metadata, knowerage_reconcile_record, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Knowerage directly.