Tool reference/ai

AI

generate_captions

Generate and save 3–5 TikTok-focused caption variants with hooks, CTAs and hashtags through Caroush. Runs asynchronously; the source field distinguishes provider AI from the existing local fallback.

Mutationcreate:captionsQueued handler
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionBackground operation

Every new action requires a UUID idempotency_key. Reuse the same key and arguments for retries. Read the approval flow.

Request contract

Input parameters

categorystringrequired
goalstringrequired
tonestringrequired
audiencestringrequired
variant_countintegerrequired
345
idempotency_keystringrequired

A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments.

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "maxLength": 80
    },
    "goal": {
      "type": "string",
      "maxLength": 80
    },
    "tone": {
      "type": "string",
      "maxLength": 80
    },
    "audience": {
      "type": "string",
      "maxLength": 120
    },
    "variant_count": {
      "type": "integer",
      "enum": [
        3,
        4,
        5
      ]
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid",
      "description": "A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments."
    }
  },
  "required": [
    "category",
    "goal",
    "tone",
    "audience",
    "variant_count",
    "idempotency_key"
  ],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools