MCP Tools Reference

Parameter schemas for each tool exposed by the Lore MCP server.

`search_knowledge_base`

Semantic search across all documents in the workspace.

Parameters:

Name	Type	Required	Default	Description
`query`	`string`	Yes	—	The search query
`limit`	`number`	No	5	Maximum number of results to return

Calls: GET /api/v1/search?q=<query>&limit=<limit>

Returns: JSON array of matching documents with similarity scores.

Example:

{
  "tool": "search_knowledge_base",
  "arguments": {
    "query": "production deployment checklist",
    "limit": 5
  }
}

Fetch full details and content of a specific document by ID.

Parameters:

Name	Type	Required	Description
`id`	`string`	Yes	The document ID to fetch

Calls: GET /api/v1/documents/<id>

Returns: Full document object including content.

Example:

{
  "tool": "get_document",
  "arguments": {
    "id": "abc123"
  }
}

List recent documents in the knowledge base.

Parameters:

Name	Type	Required	Default	Description
`limit`	`number`	No	50	Maximum number of documents to list
`offset`	`number`	No	0	Pagination offset

Calls: GET /api/v1/documents?limit=<limit>&offset=<offset>

Returns: JSON array of document summaries (no full content), ordered by updated_at descending.

Example:

{
  "tool": "list_documents",
  "arguments": {
    "limit": 20,
    "offset": 0
  }
}

If a tool call fails (e.g., invalid API key, network error, document not found), the MCP server returns an error response:

{
  "content": [{ "type": "text", "text": "Error: Lore API Error (401): Unauthorized" }],
  "isError": true
}

The agent receives the error message and can inform the user or retry.