findTestimonials
Customer quotes for use in testimonials-block. author + quote required. Optional headline = one-line key statement shown above the quote — verbatim from the quote or approved by the customer, never invented. Rating 1-5. featured: true makes it prominent. rating = stars shown on THIS quote only; the site never derives an overall rating from quotes (no JSON-LD, no brand.json rating). Has drafts: use _status:"published" to go live (draft stays hidden); schedule a future date via the schedulePost tool (collection "testimonials"). testimonials collection. Drafts: yes (publish workflow; a find WITHOUT draft:true returns the published main-table state only). Public read: yes via /api/agents. MCP capabilities: find, create, update, delete. ⚠ delete is PERMANENT (hard-delete; the admin Trash does NOT catch MCP deletes). Write ONE document at a time: wait for the response of each create/update/delete call before sending the next — parallel writes can fail with a database deadlock (HTTP 500, nothing saved; retry that call alone). Before writing public text here, call getWritingGuidelines with this collection and the locale (brand voice, writing rules, fixed terms, SEO rules, taken keywords, field rules). Fields: author (required), role (localized), company, avatar (upload: media|brand), headline (localized), quote (textarea, localized, required), rating (number, 1–5), featured (boolean), publishedAt (date).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "findTestimonials"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Optional: specific document ID to retrieve. If not provided, returns all documents | |
| page | No | Page number for pagination (default: 1) | |
| sort | No | Field to sort by (e.g., "createdAt", "-updatedAt" for descending) | |
| depth | No | How many levels deep to populate relationships (default: 0) | |
| draft | No | Optional: Whether the document should be queried from the versions table/collection or not. | |
| joins | No | Optional: configure join field queries, or pass false to disable all join fields. | |
| limit | No | Maximum number of documents to return (default: 10, max: 100) | |
| trash | No | Optional: include soft-deleted documents when trash is enabled on the collection | |
| where | No | Optional JSON string for where clause filtering (e.g., '{"title": {"contains": "test"}}') | |
| locale | No | Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields | |
| select | No | Optional: define exactly which fields you'd like to return in the response, e.g., {"title": true} | |
| populate | No | Optional: control which fields to include from populated relationship or upload documents. | |
| pagination | No | Optional: set to false to skip the count query overhead | |
| fallbackLocale | No | Optional: fallback locale code to use when requested locale is not available |