Distill AI coding sessions into weekly reports, ADRs and a knowledge graph - self-hosted
Connect Runs on your machine
claude mcp add tokenknows -e TOKENKNOWS_API_BASE=<TOKENKNOWS_API_BASE> -e TOKENKNOWS_API_TOKEN=<TOKENKNOWS_API_TOKEN> -e TOKENKNOWS_DEFAULT_PROJECT=<TOKENKNOWS_DEFAULT_PROJECT> -e TOKENKNOWS_WEB_BASE=<TOKENKNOWS_WEB_BASE> -- uvx tokenknows-mcp==0.3.0{
"mcpServers": {
"tokenknows": {
"command": "uvx",
"args": [
"tokenknows-mcp==0.3.0"
],
"env": {
"TOKENKNOWS_API_BASE": "<TOKENKNOWS_API_BASE>",
"TOKENKNOWS_API_TOKEN": "<TOKENKNOWS_API_TOKEN>",
"TOKENKNOWS_DEFAULT_PROJECT": "<TOKENKNOWS_DEFAULT_PROJECT>",
"TOKENKNOWS_WEB_BASE": "<TOKENKNOWS_WEB_BASE>"
}
}
}
}{
"mcpServers": {
"tokenknows": {
"command": "uvx",
"args": [
"tokenknows-mcp==0.3.0"
],
"env": {
"TOKENKNOWS_API_BASE": "<TOKENKNOWS_API_BASE>",
"TOKENKNOWS_API_TOKEN": "<TOKENKNOWS_API_TOKEN>",
"TOKENKNOWS_DEFAULT_PROJECT": "<TOKENKNOWS_DEFAULT_PROJECT>",
"TOKENKNOWS_WEB_BASE": "<TOKENKNOWS_WEB_BASE>"
}
}
}
}{
"servers": {
"tokenknows": {
"type": "stdio",
"command": "uvx",
"args": [
"tokenknows-mcp==0.3.0"
],
"env": {
"TOKENKNOWS_API_BASE": "<TOKENKNOWS_API_BASE>",
"TOKENKNOWS_API_TOKEN": "<TOKENKNOWS_API_TOKEN>",
"TOKENKNOWS_DEFAULT_PROJECT": "<TOKENKNOWS_DEFAULT_PROJECT>",
"TOKENKNOWS_WEB_BASE": "<TOKENKNOWS_WEB_BASE>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
TOKENKNOWS_API_BASEOptional | Self-hosted TokenKnows backend URL |
TOKENKNOWS_API_TOKENOptional, secret | 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_PROJECTOptional | Default project_id for event submission and distill |
TOKENKNOWS_WEB_BASEOptional | Web UI base URL used to build view_url links returned by distill/list tools (login required to open them) |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 11 Jun 2026 |
| Last updated | 11 Jun 2026 |
| Registry name | io.github.johnnywuj81/tokenknows |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.