Tools Reference
Complete reference for all MCP tools
MCP Tools Reference
Authentication is handled via HTTP headers (see MCP Server for setup). All tools operate within the authenticated domain context.
Read Operations
| Tool | Description |
|---|---|
list_collections | List all collections in the domain with their field schemas |
list_items | List items from a collection with optional filtering and pagination |
get_item | Get a single item by ID or slug |
get_single | Get a single item by collection slug |
Required scope: read
list_items
| Parameter | Type | Required | Description |
|---|---|---|---|
collection | string | Yes | Collection slug |
language | string | No | Language code (defaults to collection's default language) |
limit | number | No | Max items to return (default: 20, max: 100) |
offset | number | No | Items to skip for pagination |
sort | string | No | Sort field: itemDate, createdAt, updatedAt, slug |
order | string | No | Sort order: asc or desc |
get_item
| Parameter | Type | Required | Description |
|---|---|---|---|
collection | string | Yes | Collection slug |
id | string | No | Item ID (either id or slug required) |
slug | string | No | Item slug (either id or slug required) |
language | string | No | Language code (defaults to collection's default language) |
Items are returned with content for a single language. The response includes:
title- Translatable title for the requested languagetranslationData- Custom translatable fields for the requested languagedata- Non-translatable fields (same across all languages)
get_single
| Parameter | Type | Required | Description |
|---|---|---|---|
collection | string | Yes | Single collection slug |
language | string | No | Language code (defaults to collection's default language) |
Returns the single item for a single collection. Singles are collections with only one item (like Homepage, Settings). The response includes collection metadata and the item content.
Write Operations
| Tool | Description |
|---|---|
create_item | Create a new item in a collection with an initial translation |
update_item | Update an existing item's non-translatable fields (slug, date, data) |
update_translation | Create or update an item translation for a specific language |
Required scope: write
Trigger Operations
| Tool | Description |
|---|---|
list_triggers | List all triggers configured for the domain |
fire_trigger | Manually fire a trigger by ID |
Required scope: read for list_triggers, write for fire_trigger
list_triggers
Returns all triggers configured for the domain with their URL and method.
fire_trigger
| Parameter | Type | Required | Description |
|---|---|---|---|
triggerId | string | Yes | Trigger ID to fire |
Manually executes the trigger and returns the execution result. The response includes:
success- Whether the trigger executed successfullystatus-SUCCESSorFAILEDstatusCode- HTTP response code (if applicable)durationMs- Execution time in millisecondserror- Error message (if failed)
Error Handling
Tools return errors in a consistent format:
{
"isError": true,
"content": [{ "type": "text", "text": "Error: <message>" }]
}Common errors: unauthorized, collection not found, item not found, slug already in use, invalid language.