Tool Reference

search_repository_items

Search for content items in the brand repository.

Search for content items in the brand repository by matching against titles and content.

Parameters

Parameter Type Required Description
brandId string Yes The brand ID (UUID) or brand name (e.g., "Ace Auto Repair")
query string Yes Search query to match against titles and content
limit number No Maximum number of items to return (default: 20)

Example Request

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "search_repository_items",
      "arguments": {
        "brandId": "brand_abc123",
        "query": "oil change",
        "limit": 5
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "id": "item_010",
    "title": "Conventional vs Synthetic Oil Change",
    "content": "We offer both conventional and full synthetic oil changes...",
    "category": "blog",
    "url": "https://aceautorepair.com/blog/oil-change-guide",
    "metadata": {},
    "createdAt": "2025-10-05T08:00:00.000Z",
    "updatedAt": "2026-01-15T11:30:00.000Z"
  }
]

Output Schema

Returns an array of repository item objects (same schema as get_repository_items):

Field Type Description
id string Item UUID
title string Item title
content string Item content body
category string Category
url string Source URL
metadata object Additional metadata
createdAt string ISO 8601 creation timestamp
updatedAt string ISO 8601 last update timestamp

Notes

  • Search is case-insensitive and matches against both title and content fields.
  • Results are returned in reverse chronological order (newest first).
  • If no items match, an empty array is returned.