Skip to main content

MCP Integration

What this page is for

Describe how MCP tooling accesses RAGler knowledge.

Component role

MCP is a built-in module of the backend (not a separate service). It exposes MCP protocol endpoints directly from the NestJS application:

  • Streamable HTTPPOST /mcp (MCP 2025-03-26 spec)
  • Legacy SSEGET /sse + POST /messages

Available tools

ToolDescription
search_knowledgeSemantic search across collections with filters
list_collectionsList all knowledge collections
get_collection_infoGet details of a specific collection

Runtime path

MCP Client → Backend /mcp endpoint → McpToolsService → VectorService / CollectionService → Qdrant

No HTTP round-trip between MCP and backend — tools call services directly via NestJS dependency injection.

Constraints

  • Read-oriented operations for knowledge querying.
  • MCP endpoints are excluded from the /api prefix and throttler guard.