Skip to content

Model Context Protocol (MCP)

The MCP server exposes haiku.rag as MCP tools for compatible MCP clients like Claude Desktop.

Available Tools

Document Management

  • add_document_from_file - Add documents from local file paths
  • file_path (required): Path to the file
  • metadata (optional): Key-value metadata

  • title (optional): Human-readable title

  • add_document_from_url - Add documents from URLs

  • url (required): URL to fetch
  • metadata (optional): Key-value metadata

  • title (optional): Human-readable title

  • add_document_from_text - Add documents from raw text content

  • content (required): Text content
  • uri (optional): URI identifier
  • metadata (optional): Key-value metadata

  • title (optional): Human-readable title

  • get_document - Retrieve a document by ID

  • document_id (required): The document ID

  • list_documents - List documents with pagination and filtering

  • limit (optional): Maximum number to return
  • offset (optional): Number to skip

  • filter (optional): SQL WHERE clause for filtering

  • delete_document - Delete a document by ID

  • document_id (required): The document ID
  • search_documents - Search using hybrid search (vector + full-text)
  • query (required): Search query
  • limit (optional): Maximum results (default: 5)

Question Answering

  • ask_question - Ask questions about your documents
  • question (required): The question to ask
  • cite (optional): Include source citations (default: false)

  • deep (optional): Use multi-agent deep QA for complex questions (default: false)

  • research_question - Run multi-agent research on complex topics

  • question (required): The research question
  • Returns a structured research report with findings, conclusions, and sources

Starting MCP Server

The MCP server supports Streamable HTTP and stdio transports:

# Default streamable HTTP transport on port 8001
haiku-rag serve --mcp

# Custom port
haiku-rag serve --mcp --mcp-port 9000

# stdio transport (for Claude Desktop)
haiku-rag serve --mcp --stdio

Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "haiku-rag": {
      "command": "haiku-rag",
      "args": ["serve", "--mcp", "--stdio"]
    }
  }
}

With a custom database path:

{
  "mcpServers": {
    "haiku-rag": {
      "command": "haiku-rag",
      "args": ["serve", "--mcp", "--stdio", "--db", "/path/to/database.lancedb"]
    }
  }
}

After restarting Claude Desktop, you can ask Claude to search your documents, add new content, or answer questions using your knowledge base.

Running with Other Services

Combine MCP with file monitoring or AG-UI:

# MCP + file monitoring
haiku-rag serve --mcp --monitor

# MCP + AG-UI streaming
haiku-rag serve --mcp --agui

# All services
haiku-rag serve --mcp --monitor --agui

See Server Mode for details on file monitoring and AG-UI.