MCP Tools Reference
Lore DB exposes 18 MCP tools when connected. Here’s the complete reference.
Document tools
create_doc
Create and store a document. By default it is added to your Personal library. Optionally specify a library_id to add it to a specific library. Long documents are automatically split into overlapping chunks for better search coverage.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_name | string | Yes | Title of the document |
document_content | string | Yes | Markdown content |
library_id | string | No | Target library (defaults to Personal) |
restricted | boolean | No | Mark as restricted access |
read_doc
Read a specific document from Lore DB. Returns the full title and content.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
update_doc
Update an existing document, replacing the current content. Chunks and embeddings are automatically regenerated.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
document_content | string | Yes | New markdown content |
delete_doc
Delete a document from Lore DB permanently.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
verify_doc
Mark a document as verified — bumps its verified_at timestamp without changing content. Freshly verified documents rank higher in search.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
Search & AI tools
search_doc
Hybrid search (semantic similarity + keyword matching + freshness ranking). Returns ranked results with id, title, and score.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_query | string | Yes | Natural language search query |
library_id | string | No | Scope to a specific library |
system_id | string | No | Scope to a specific system |
ask_doc
Ask a question and get an AI-generated answer based on your documents. Uses RAG: retrieves relevant documents via hybrid search, then generates an answer grounded in their content.
| Parameter | Type | Required | Description |
|---|---|---|---|
question | string | Yes | Natural language question |
library_id | string | No | Scope to a specific library |
system_id | string | No | Scope to a specific system |
Library tools
list_libraries
List all libraries the user is a member of. Shows which libraries are active (included in search/ask).
No parameters.
create_library
Create a new library. The caller becomes the owner.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Library name |
description | string | No | Library description |
add_doc_to_library
Add a document to a library. The document must be accessible to you.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
library_id | string | Yes | UUID of the library |
remove_doc_from_library
Remove a document from a library. Requires editor or owner role.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
library_id | string | Yes | UUID of the library |
move_doc_between_libraries
Move a document from one library to another. Requires editor/owner role in both libraries.
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | UUID of the document |
from_library_id | string | Yes | Source library UUID |
to_library_id | string | Yes | Destination library UUID |
System tools
list_systems
List all systems the user is a member of. Shows which systems are active.
No parameters.
create_system
Create a new system (a grouping of libraries). The caller becomes the owner.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | System name |
description | string | No | System description |
add_library_to_system
Add a library to a system. Requires editor or owner role in the system, and membership in the library.
| Parameter | Type | Required | Description |
|---|---|---|---|
system_id | string | Yes | UUID of the system |
library_id | string | Yes | UUID of the library |
remove_library_from_system
Remove a library from a system. Requires editor or owner role in the system.
| Parameter | Type | Required | Description |
|---|---|---|---|
system_id | string | Yes | UUID of the system |
library_id | string | Yes | UUID of the library |
reindex_documents
Re-chunk and re-embed all documents. Admin only. Run this after deploying chunking changes or changing the embedding model. This is a heavy operation.
No parameters. Requires admin access.
Use list_libraries and list_systems to discover IDs, then pass them to search_doc or ask_doc to scope your queries.