Thorbit KB MCP

Local stdio MCP server for Thorbit Knowledge Base tools. The package proxies tool calls to hosted Thorbit API routes; it does not connect to the database directly.

Install

Generate a Thorbit MCP API key from Thorbit Settings -> MCPs, then run the stdio server through your MCP client:

npx -y thorbit-kb-mcp@latest

MCP client example:

{
  "mcpServers": {
    "thorbit-kb": {
      "command": "npx",
      "args": ["-y", "thorbit-kb-mcp@latest"],
      "env": {
        "THORBIT_API_KEY": "thbt_mcp_..."
      }
    }
  }
}

Generate the same JSON from the CLI:

npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...

Optional:

• THORBIT_BASE_URL: hosted Thorbit app URL. Defaults to https://thorbit.ai.
• THORBIT_KB_MCP_KEY_PATH: file containing the API key. Defaults to ~/.thorbit-kb-mcp-key.
• thorbit-kb-mcp-install: prints a terracotta Thorbit KB setup screen by default.
• thorbit-kb-mcp-install --json: prints only MCP client JSON for scripts.
• thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key: emits config that reads the key from a local file instead of embedding it inline.

Internal Admin Key

Internal Thorbit operator keys should be generated from the app repo, not the Settings UI:

npm run mcp:admin-key -- --org-id org_... --base-url https://thorbit.ai

The command writes the raw key to ~/.thorbit-kb-mcp-admin-key with 0600 permissions and prints an MCP config that references THORBIT_KB_MCP_KEY_PATH. Admin keys bypass credit deduction, but provider cost and MCP tool usage are still logged.

Tools

• thorbit_kb_list
• thorbit_kb_create
• thorbit_kb_source_status
• thorbit_kb_ingest_url
• thorbit_kb_ingest_site
• thorbit_kb_ingest_youtube
• thorbit_kb_ingest_text
• thorbit_kb_search
• thorbit_kb_ask

External ingestion tools use MCP Scraper through hosted Thorbit and may incur provider cost.