Tools and API

The catalog contains read-only actions for products, categories, niches, brands, sellers, summaries, favorites, and marketplaces. Search in Russian, Kazakh, Chinese, or English; the full schema is loaded separately for the selected action. The default global cap is 20 analytics calls per second; an administrator can edit it and related limits in MCP settings. Current values are returned by search_actions and describe_action; read them before analytics calls.

Authentication

For key-based clients, send Authorization: Bearer <your key>. Web clients connected with OAuth sign in through Dattoria.

HTTP HEADER

Authorization: Bearer YOUR_DATTORIA_MCP_TOKEN

Limits

Set marketplace only when it appears in the selected action schema; allowed values are kaspi and teez. When supported by the schema, send dateFrom and dateTo together as YYYY-MM-DD. The range is at most 180 days and cannot end in the future. Request one page per call and follow the page and limit bounds in the selected action schema. Text fields are bounded by the selected action schema; search_actions accepts 1 to 120 characters.

Tools

The server exposes four compact MCP tools and a catalog of allowlisted read actions. An agent first finds an action, loads its schema on demand, then runs one report or a sequential workflow of up to five steps.

search_actionsFind actions

Searches the compact catalog and returns stable action IDs. Supports several languages and minor typos.

Required fields: query
Optional fields: section, limit (1–12)

CALL EXAMPLE

{
  "query": "поиск товаров",
  "section": "products",
  "limit": 8
}

describe_actionDescribe an action

Returns the full argument schema, limits, and field meanings for one discovered action.

Required fields: actionId
Optional fields: -

CALL EXAMPLE

{
  "actionId": "products.search"
}

execute_actionRun an action

Runs one read-only action. Arguments are checked against the schema returned by describe_action.

Required fields: actionId, arguments
Optional fields: - (поля arguments зависят от схемы действия)

CALL EXAMPLE

{
  "actionId": "products.search",
  "arguments": {
    "marketplace": "kaspi",
    "search": "smartphones",
    "page": 1,
    "limit": 20
  }
}

execute_workflowRun a workflow

Runs one to five actions sequentially, applies shared filters, and can create a temporary JSON or CSV export.

Required fields: steps (1–5)
Optional fields: defaults, continueOnError, outputFormat (json or csv)

CALL EXAMPLE

{
  "defaults": {
    "marketplace": "kaspi",
    "dateFrom": "2026-09-01",
    "dateTo": "2026-09-30"
  },
  "steps": [
    {
      "actionId": "products.search",
      "arguments": {"search": "smartphones", "page": 1, "limit": 20}
    },
    {
      "actionId": "categories.search",
      "arguments": {"search": "phones", "page": 1, "limit": 20}
    }
  ],
  "continueOnError": true,
  "outputFormat": "json"
}

Detailed workflow examplesworkflows.md

MCP specificationModel Context Protocol