Back to Dashboard
API Discovery
Back to Tools

search_knowledge

read:knowledge

Search the business knowledge base using semantic (AI-powered) search. Great for finding answers to FAQs, policies, service details, and business information.

Input Parameters

Parameters

PropertyTypeDescription
queryrequiredstringSearch query (1-500 chars)
limitnumber(default: 5)Max results (1-20)
similarityThresholdnumber(default: 0.3)Minimum relevance (0-1)

Response

Response Schema

PropertyTypeDescription
resultsrequiredKnowledgeResult[]Matching knowledge items
queryrequiredstringThe search query
totalFoundrequirednumberTotal matches

Example

Requestjson
{
  "type": "tool",
  "name": "search_knowledge",
  "params": {
    "query": "Do you offer gift cards?",
    "limit": 3
  }
}
Responsejson
{
  "success": true,
  "data": {
    "results": [
      {
        "id": "kb-uuid",
        "question": "Do you sell gift cards?",
        "answer": "Yes! We offer gift cards in any amount...",
        "category": "Products",
        "relevance": 0.94
      }
    ],
    "query": "Do you offer gift cards?",
    "totalFound": 2
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "search_knowledge",\n  "params": {\n    "query": "Do you offer gift cards?",\n    "limit": 3\n  }\n}'