Back to Resources

knowledge

read:knowledge
bizily://knowledge

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

Parameters

Input Parameters

PropertyTypeDescription
queryrequiredstringSearch query (1-500 characters)
limitnumber(default: 5)Max results (1-20)
similarityThresholdnumber(default: 0.3)Minimum relevance score (0-1)
vectorWeightnumber(default: 0.6)Semantic search weight (0-1)
textWeightnumber(default: 0.4)Keyword search weight (0-1)

Response

Response Schema

PropertyTypeDescription
itemsrequiredKnowledgeItem[]Matching knowledge items
queryrequiredstringThe search query
totalFoundrequirednumberTotal matches found

Example

Requestjson
{
  "type": "resource",
  "name": "knowledge",
  "params": {
    "query": "What are your cancellation policies?",
    "limit": 3
  }
}
Responsejson
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "kb-uuid",
        "question": "What is your cancellation policy?",
        "answer": "Cancellations must be made 24 hours in advance...",
        "category": "Policies",
        "relevance": {
          "semantic": 0.92,
          "keyword": 0.85,
          "combined": 0.89
        }
      }
    ],
    "query": "What are your cancellation policies?",
    "totalFound": 3
  }
}

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": "resource",\n  "name": "knowledge",\n  "params": {\n    "query": "What are your cancellation policies?",\n    "limit": 3\n  }\n}'