Для AI-агентов: markdown этой страницы — /docs/mcp-statuses.mdиндекс документации — /llms.txt
MCP: statuses
Обновлено
MCP: statuses
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
create_order_status
Create a new order status for the tenant. Provide a title + group (in_progress/success/fail); optionally a description, a user-notification flag, a sort weight, and a structural status-notification button target. Returns the created status with its assigned seqNum.
{
"description": "Create a new order status for the tenant. Provide a title + group (in_progress/success/fail); optionally a description, a user-notification flag, a sort weight, and a structural status-notification button target. Returns the created status with its assigned `seqNum`.",
"domain": "statuses",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"button_target": {
"description": "Value for button target.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
"button_title": {
"description": "Value for button title.",
"maxLength": 100,
"type": "string"
},
"description": {
"description": "Value for description.",
"maxLength": 4000,
"type": "string"
},
"group": {
"description": "Value for group.",
"enum": [
"in_progress",
"success",
"fail"
],
"type": "string"
},
"notify_user": {
"description": "Value for notify user.",
"type": "boolean"
},
"sort": {
"description": "Value for sort.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"title": {
"description": "Value for title.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"group"
],
"type": "object"
},
"name": "create_order_status",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"statuses:write"
],
"risk": "write",
"scope": "statuses:write",
"title": "Create Order Status"
}delete_order_status
Soft-delete an order status by seqNum. Idempotent (deleting an absent/already-deleted status returns deleted:true). System statuses (the built-in New/Success/Fail buckets) cannot be deleted — that errors CONFLICT.
{
"description": "Soft-delete an order status by `seqNum`. Idempotent (deleting an absent/already-deleted status returns deleted:true). System statuses (the built-in New/Success/Fail buckets) cannot be deleted — that errors CONFLICT.",
"domain": "statuses",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "delete_order_status",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"statuses:write"
],
"risk": "destructive",
"scope": "statuses:write",
"title": "Delete Order Status"
}list_order_statuses
List the tenant order-status set (the buckets an order moves through: e.g. New → Packing → Shipped → Done). Returns each status with its seqNum (the id you pass to update/delete), title, group (in_progress/success/fail), notify flag, sort and optional button. 0-cost read.
{
"description": "List the tenant order-status set (the buckets an order moves through: e.g. New → Packing → Shipped → Done). Returns each status with its `seqNum` (the id you pass to update/delete), title, group (in_progress/success/fail), notify flag, sort and optional button. 0-cost read.",
"domain": "statuses",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_order_statuses",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"statuses:read"
],
"risk": "read",
"scope": "statuses:read",
"title": "List Order Statuses"
}update_order_status
Update an existing order status by its seqNum (a partial patch — send only the fields you change). Idempotent: re-sending the same patch is a no-op. Returns the updated status. Errors NOT_FOUND if the seqNum does not exist for your tenant.
{
"description": "Update an existing order status by its `seqNum` (a partial patch — send only the fields you change). Idempotent: re-sending the same patch is a no-op. Returns the updated status. Errors NOT_FOUND if the seqNum does not exist for your tenant.",
"domain": "statuses",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"button_target": {
"anyOf": [
{
"description": "Value for button target option.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
{
"description": "Value for button target option.",
"type": "null"
}
],
"description": "Value for button target."
},
"button_title": {
"anyOf": [
{
"description": "Value for button title option.",
"maxLength": 100,
"type": "string"
},
{
"description": "Value for button title option.",
"type": "null"
}
],
"description": "Value for button title."
},
"description": {
"anyOf": [
{
"description": "Value for description option.",
"maxLength": 4000,
"type": "string"
},
{
"description": "Value for description option.",
"type": "null"
}
],
"description": "Value for description."
},
"group": {
"description": "Value for group.",
"enum": [
"in_progress",
"success",
"fail"
],
"type": "string"
},
"notify_user": {
"description": "Value for notify user.",
"type": "boolean"
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sort": {
"description": "Value for sort.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"title": {
"description": "Value for title.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "update_order_status",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"statuses:write"
],
"risk": "write",
"scope": "statuses:write",
"title": "Update Order Status"
}