TokenKnows MCP

A self-hosted MCP server that distills AI coding sessions from tools like Claude Code, Codex, and Cursor into structured outputs including weekly reports, Architecture Decision Records (ADRs), incident reviews, and a local knowledge graph. It features a three-layer LLM egress gate with audit logging and supports local inference via Ollama.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by johnnywuj81

You need:Install the plugin Prerequisite: the TokenKnows backend at http://localhost:8001 and the web UI at http://localhost:5173 (see Quick start), plus uv (the plugin pulls the MCP server from PyPI via uvx )Register/login in the web UI and create an API token under Project Settings → MCP 接入 when your backend requires auth

Vendor documentation

What you can do with it

Generate weekly reports from AI coding sessions
Create Architecture Decision Records (ADRs)
Build a local knowledge graph from code interactions
Conduct incident reviews using session data

Source and maintenance

Community listingRegistry 0.3.0

mcp-registry: io.github.johnnywuj81/tokenknows@0.3.0 Source repository

Maintenance checked: Nov 1, 2026, 6:05 AM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

tokenknows-mcp 0.3.0

pypi

tokenknows-mcp package definition

{
  "version": "0.3.0",
  "transport": "stdio",
  "identifier": "tokenknows-mcp",
  "registryType": "pypi",
  "environmentVariables": [
    {
      "name": "TOKENKNOWS_API_BASE",
      "format": "string",
      "default": "http://127.0.0.1:8001",
      "description": "Self-hosted TokenKnows backend URL"
    },
    {
      "name": "TOKENKNOWS_API_TOKEN",
      "format": "string",
      "description": "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)"
    },
    {
      "name": "TOKENKNOWS_DEFAULT_PROJECT",
      "format": "string",
      "default": "proj-demo-001",
      "description": "Default project_id for event submission and distill"
    },
    {
      "name": "TOKENKNOWS_WEB_BASE",
      "format": "string",
      "default": "http://127.0.0.1:5173",
      "description": "Web UI base URL used to build view_url links returned by distill/list tools (login required to open them)"
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "tokenknows-mcp": {
      "command": "uvx",
      "args": [
        "tokenknows-mcp==0.3.0"
      ],
      "env": {
        "TOKENKNOWS_API_BASE": "<YOUR_TOKENKNOWS_API_BASE>",
        "TOKENKNOWS_API_TOKEN": "<YOUR_TOKENKNOWS_API_TOKEN>",
        "TOKENKNOWS_DEFAULT_PROJECT": "<YOUR_TOKENKNOWS_DEFAULT_PROJECT>",
        "TOKENKNOWS_WEB_BASE": "<YOUR_TOKENKNOWS_WEB_BASE>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "tokenknows-mcp": {
      "command": "uvx",
      "args": [
        "tokenknows-mcp==0.3.0"
      ],
      "env": {
        "TOKENKNOWS_API_BASE": "<YOUR_TOKENKNOWS_API_BASE>",
        "TOKENKNOWS_API_TOKEN": "<YOUR_TOKENKNOWS_API_TOKEN>",
        "TOKENKNOWS_DEFAULT_PROJECT": "<YOUR_TOKENKNOWS_DEFAULT_PROJECT>",
        "TOKENKNOWS_WEB_BASE": "<YOUR_TOKENKNOWS_WEB_BASE>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "tokenknows-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tokenknows-mcp==0.3.0"
      ],
      "env": {
        "TOKENKNOWS_API_BASE": "<YOUR_TOKENKNOWS_API_BASE>",
        "TOKENKNOWS_API_TOKEN": "<YOUR_TOKENKNOWS_API_TOKEN>",
        "TOKENKNOWS_DEFAULT_PROJECT": "<YOUR_TOKENKNOWS_DEFAULT_PROJECT>",
        "TOKENKNOWS_WEB_BASE": "<YOUR_TOKENKNOWS_WEB_BASE>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "tokenknows-mcp": {
      "command": "uvx",
      "args": [
        "tokenknows-mcp==0.3.0"
      ],
      "env": {
        "TOKENKNOWS_API_BASE": "<YOUR_TOKENKNOWS_API_BASE>",
        "TOKENKNOWS_API_TOKEN": "<YOUR_TOKENKNOWS_API_TOKEN>",
        "TOKENKNOWS_DEFAULT_PROJECT": "<YOUR_TOKENKNOWS_DEFAULT_PROJECT>",
        "TOKENKNOWS_WEB_BASE": "<YOUR_TOKENKNOWS_WEB_BASE>"
      }
    }
  }
}

Let your agent find its tools

Find servers like TokenKnows MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 6,641