Logo IconGuided Mind
v2.4
Integration

MCP Per Tool

Detailed parameter documentation for every MCP tool.

Complete reference for each MCP tool with parameters, examples, and response formats.

rag_search

Search your document index for relevant chunks.

Parameters

ParameterTypeDefaultDescription
queryrequiredstring—Search query text
kinteger—Number of results to return (default: 10)
thresholdfloat—Min similarity score (0-1, default: 0.5)
document_idslist[string]—Optional list of document IDs to filter search (default: null)

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rag_search",
    "arguments": {
      "query": "What is the return policy?",
      "k": 5,
      "threshold": 0.7
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "text": "Our return policy allows returns within 30 days...",
        "score": 0.92,
        "document_id": "doc_abc123",
        "document_name": "policies.pdf"
      }
    ],
    "metadata": {
      "chunks_retrieved": 5,
      "processing_time_ms": 234
    }
  }
}

upload_document

Upload a document to your project (processing happens separately).

Parameters

ParameterTypeDefaultDescription
file_pathrequiredstring—Path to the document file
file_namerequiredstring—Name of the file
content_typestring—MIME type of the file (default: application/octet-stream)
configobject—Optional processing config: preprocessing, chunking, embedding (default: null)
metadataobject—Optional metadata for the document (default: null)

Example Call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "upload_document",
    "arguments": {
      "file_path": "./policies.pdf",
      "file_name": "policies.pdf",
      "content_type": "application/pdf"
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "document_id": "doc_xyz789",
    "filename": "policies.pdf",
    "status": "uploaded",
    "message": "Document uploaded successfully."
  }
}

upload_and_process

Upload a document and immediately start processing.

Parameters

ParameterTypeDefaultDescription
file_pathrequiredstring—Path to the document file
file_namerequiredstring—Name of the file
content_typestring—MIME type of the file (default: application/octet-stream)
configobject—Optional processing config: preprocessing, chunking, embedding (default: null)
metadataobject—Optional metadata for the document (default: null)

Example Call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "upload_and_process",
    "arguments": {
      "file_path": "./policies.pdf",
      "file_name": "policies.pdf",
      "content_type": "application/pdf",
      "config": {
        "chunking": { "chunk_size": 512, "chunk_overlap": 50 }
      }
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "document_id": "doc_xyz789",
    "filename": "policies.pdf",
    "status": "processing",
    "chunks_created": 42,
    "message": "Document uploaded and processing started."
  }
}

Use upload_and_process for single documents. Use upload_document when batching multiple files before triggering processing.

← PreviousMCP OverviewNext →n8n Integration