mcpbeat Sign in

TokenKnows MCP Server

by johnnywuj81 Your server? Claim it
local only

TokenKnows runs on your own machine — the client starts it, so there is no endpoint to ping. 87 installs a week from pypi. Last commit 11 Jun 2026.

Distill AI coding sessions into weekly reports, ADRs and a knowledge graph - self-hosted

Installs per day peak 29 · avg 13 · -22% w/w
a month agotoday
87
Installs / week
pypi · tokenknows-mcp
4
Stars
0 open issues
11 Jun 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 4 d ago · rules 995398eba69f

In the project's build, not in the package

Found in continuous integration, deployment or infrastructure files, or in a neighbouring package of the same monorepo. None of this is installed when you add the server: it describes how the project is built and released. We list it because a leaked key in a build pipeline is still a real problem, but it is not something this server does on your machine.

Reads files and sends them to the network plugins/local-docs/sync.py:370
    for root, dirs, names in os.walk(watch_dir):

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Nothing serious here today

Today is the operative word: we check TokenKnows every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add tokenknows -- uvx tokenknows-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "tokenknows": {
      "command": "uvx",
      "args": [
        "tokenknows-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.tokenknows]
command = "uvx"
args = ["tokenknows-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "tokenknows": {
      "command": "uvx",
      "args": [
        "tokenknows-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "tokenknows": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tokenknows-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: TOKENKNOWS_API_BASE (Self-hosted TokenKnows backend URL), TOKENKNOWS_API_TOKEN (API token (tkk_...) or JWT bearer for the backend; create one in the web UI under Project Settings - MCP Access (optional for default local deployments)), TOKENKNOWS_DEFAULT_PROJECT (Default project_id for event submission and distill), TOKENKNOWS_WEB_BASE (Web UI base URL used to build view_url links returned by distill/list tools (login required to open them)).

Alternatives to TokenKnows

same job, measured the same way
Kebivo
by ocnai

Self-hosted inbox for questions your AI agents couldn't answer. Report knowledge gaps over MCP.

local only
knowledge
by to0wnn

Self-hosted shared memory and docs for Claude Code, Codex and Antigravity agents, with a graph UI

local only
Cgraphy
by pmgarg

Code knowledge graph over MCP: token-budgeted context for AI coding agents.

62 installs/wk local only
codebase-synapse
by iwiels

Indexes codebase into a local knowledge graph with 40+ AI tools and codebase-guard.

45 installs/wk local only
Crg
by n24q02m

Token-efficient code review knowledge graph: semantic search and call-graph resolution.

1 782 installs/wk local only
Better Code Review Graph
by n24q02m

Token-efficient code review knowledge graph: semantic search and call-graph resolution.

local only
Codeseeker
by jghiringhelli

Graph-powered code intelligence with semantic search and knowledge graph for AI assistants

369 installs/wk local only
Hypermnesia MCP Viz
by cdeust

Read-only visualization for Cortex memory, knowledge, sessions, traces, and codebase graphs.

170 installs/wk local only

TokenKnows — questions

Answers built from our own checks of this server.

Why is there no uptime for TokenKnows?
TokenKnows runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package tokenknows-mcp was installed 87 times last week.
How do I connect TokenKnows?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls tokenknows-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use TokenKnows?
The pypi package tokenknows-mcp was installed 87 times in the last week. Week over week that is -22%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is TokenKnows open source?
Yes — it is published under the MIT licence, written in Python and 4 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.