KB Server SOP
thorbit-kb-mcp v0.2.6
Self-sufficient — no
projectPublicId required. KBs can be org-level (omit projectPublicId).All 9 Tools
| Tool | Required | Optional | Notes |
|---|---|---|---|
| thorbit_kb_create | name | description, projectPublicId, folder | Creates a new knowledge base |
| thorbit_kb_list | none | projectPublicId, includeGlobal, limit | Lists available KBs |
| thorbit_kb_source_status | sourcePublicIds | none | Check ingestion status by source IDs |
| thorbit_kb_ingest_url | knowledgeBasePublicId, url | title, mode, maxCharacters, metadata | Ingest a single URL |
| thorbit_kb_ingest_site | knowledgeBasePublicId, startUrl | includePatterns, excludePatterns, maxPages (def 25, cap 100), mode, metadata | Crawl and ingest a whole site |
| thorbit_kb_ingest_youtube | knowledgeBasePublicId, videoUrl | title, mode, preserveTimestamps, metadata | Ingest a YouTube video transcript |
| thorbit_kb_ingest_text | knowledgeBasePublicId, title, content | sourceUrl, sourceType, metadata | Ingest raw text directly |
| thorbit_kb_search | query | knowledgeBasePublicId, projectPublicId, limit, includeEntities, searchMode (smart/hybrid) | Vector search — returns chunks with scores + citations |
| thorbit_kb_ask | question | knowledgeBasePublicId, projectPublicId, answerStyle (concise/detailed/extractive), limit, requireCitations | RAG answer with decomposed queries, reranking, citations |
Resources
thorbit-kb://knowledge-bases— list all KBsthorbit-kb://sources/{sourcePublicId}— source details
Proven RAG Loop
1
thorbit_kb_create — create a named KB (org-level or project-scoped)
2
thorbit_kb_ingest_url / thorbit_kb_ingest_text / thorbit_kb_ingest_site — ingest content into the KB
3
thorbit_kb_search— returns chunk with score + citation (proven: searching "secret passphrase" returned correct chunk)
4
thorbit_kb_ask — returns full answer with citation,
sufficient=true, decomposed queries, reranked resultsAppend-only: Ingestion is append-only in V1 — refresh is off. To remove content, delete the KB in the thorbit.ai web app. There is no delete tool in the MCP.