Tool reference/products

PRODUCTS

create_product

Save a product and queue Caroush product analysis. Provide a meaningful description; audience and content themes are optional reviewed editorial preferences.

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

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

Request contract

Input parameters

namestringrequired
descriptionstring
website_urlstring | string
logo_urlstring | string
target_audiencesarray
content_typesarray
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": {
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "website_url": {
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "uri",
          "pattern": "^https?://",
          "maxLength": 2048
        }
      ]
    },
    "logo_url": {
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "uri",
          "pattern": "^https?://",
          "maxLength": 2048
        }
      ]
    },
    "target_audiences": {
      "type": "array",
      "maxItems": 30,
      "items": {
        "type": "string",
        "maxLength": 500
      }
    },
    "content_types": {
      "type": "array",
      "maxItems": 12,
      "items": {
        "type": "string",
        "maxLength": 160
      }
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid",
      "description": "A new UUID per intended action. Reuse exactly for retries; never reuse with different arguments."
    }
  },
  "required": [
    "name",
    "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