Подписание
Инструменты раздела «Подписание»: 7
Подключение: https://mcp.legalstack.ru/mcp/signatures или в составе общего подключения https://mcp.legalstack.ru/mcp.
Отправить документ на подписание
create_signature_request · необратимое действие
Описание для модели: Send a document for signing to members or outside people. Signers at once receive real links or codes. A signer is either a team member by member_id or an outside person by name and email. The document text is fixed at this moment.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
document_id | string | да | Document id. Длина: 1–64. |
title | string | да | Request title, usually the document name. Длина: 1–500. |
signers | массив объектов | да | People who sign. Элементов: 1–50. |
signers[].member_id | string | нет | Team member who signs, from list_members. Длина: 1–64. |
signers[].name | string | нет | Name of an outside signer. Длина: 1–200. |
signers[].email | string | нет | Email of an outside signer. Длина: 3–320. |
signers[].method | string | нет | How the signer signs, a code from an email by default. Значения: Код из письма, Код из Telegram, УКЭП, УНЭП, Факсимиле, AR-подпись. |
signers[].role | string | нет | Role of the signer, signs by default. Значения: Подписант, Согласующий, Заполняющий, Наблюдатель. |
signers[].position | integer | нет | Turn of the signer when signing in order. Диапазон: 1–100. |
order | string | нет | Signers act all at once or in turn, at once by default. Значения: Одновременно, По очереди. |
message | string | нет | Message shown to signers. Длина: до 5000. |
expires_at | string | нет | Deadline for signing, YYYY-MM-DDTHH:MM in the team time zone unless an offset is given. |
JSON Schema параметров
{
"type": "object",
"properties": {
"document_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Document id"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Request title, usually the document name"
},
"signers": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"member_id": {
"description": "Team member who signs, from list_members",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"name": {
"description": "Name of an outside signer",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Email of an outside signer",
"type": "string",
"minLength": 3,
"maxLength": 320
},
"method": {
"type": "string",
"enum": [
"Код из письма",
"Код из Telegram",
"УКЭП",
"УНЭП",
"Факсимиле",
"AR-подпись"
],
"description": "How the signer signs, a code from an email by default"
},
"role": {
"type": "string",
"enum": [
"Подписант",
"Согласующий",
"Заполняющий",
"Наблюдатель"
],
"description": "Role of the signer, signs by default"
},
"position": {
"description": "Turn of the signer when signing in order",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
},
"description": "People who sign"
},
"order": {
"type": "string",
"enum": [
"Одновременно",
"По очереди"
],
"description": "Signers act all at once or in turn, at once by default"
},
"message": {
"description": "Message shown to signers",
"type": "string",
"maxLength": 5000
},
"expires_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}",
"description": "Deadline for signing, YYYY-MM-DDTHH:MM in the team time zone unless an offset is given"
}
},
"required": [
"document_id",
"title",
"signers"
],
"additionalProperties": false
}Удалить запрос на подписание
delete_signature_request · необратимое действие
Описание для модели: Delete a signature request. Cannot be restored. To stop a request and keep it use revoke_signature_request.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
request_id | string | да | Signature request id. Длина: 1–64. |
JSON Schema параметров
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Signature request id"
}
},
"required": [
"request_id"
],
"additionalProperties": false
}Карточка запроса на подписание
get_signature_request · только чтение
Описание для модели: Get a signature request with signers and their statuses.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
request_id | string | да | Signature request id. Длина: 1–64. |
JSON Schema параметров
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Signature request id"
}
},
"required": [
"request_id"
],
"additionalProperties": false
}Подписи под документом
list_document_signatures · только чтение
Описание для модели: List signatures already placed on a document.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
document_id | string | да | Document id. Длина: 1–64. |
JSON Schema параметров
{
"type": "object",
"properties": {
"document_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Document id"
}
},
"required": [
"document_id"
],
"additionalProperties": false
}Запросы на подписание
list_signature_requests · только чтение
Описание для модели: List signature requests received or sent by the user. The inbox holds requests where the current user signs, sent holds requests the user started.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
box | string | нет | Inbox by default. Значения: inbox, sent. |
status | string | нет | Request status. Значения: Ожидает подписания, Подписано, Завершено, Отклонено, Срок истёк, Отозвано. |
limit | integer | нет | Maximum number of items to return, 20 by default. По умолчанию: 20. Диапазон: 1–100. |
offset | integer | нет | Number of items to skip, for paging. По умолчанию: 0. Диапазон: 0–9007199254740991. |
JSON Schema параметров
{
"type": "object",
"properties": {
"box": {
"description": "Inbox by default",
"type": "string",
"enum": [
"inbox",
"sent"
]
},
"status": {
"type": "string",
"enum": [
"Ожидает подписания",
"Подписано",
"Завершено",
"Отклонено",
"Срок истёк",
"Отозвано"
],
"description": "Request status"
},
"limit": {
"default": 20,
"description": "Maximum number of items to return, 20 by default",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Number of items to skip, for paging",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"additionalProperties": false
}Отказаться от подписания
reject_signature_request · необратимое действие
Описание для модели: Refuse to sign a document as the current user. The initiator is notified. To cancel a request the user started use revoke_signature_request.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
request_id | string | да | Signature request id. Длина: 1–64. |
reason | string | нет | Reason of the refusal. Длина: 1–2000. |
JSON Schema параметров
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Signature request id"
},
"reason": {
"description": "Reason of the refusal",
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"request_id"
],
"additionalProperties": false
}Отозвать запрос на подписание
revoke_signature_request · изменяет данные
Описание для модели: Cancel a signature request, only its initiator can. Signers are notified, the request is kept in the list.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
request_id | string | да | Signature request id. Длина: 1–64. |
reason | string | нет | Reason shown to signers. Длина: 1–2000. |
JSON Schema параметров
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Signature request id"
},
"reason": {
"description": "Reason shown to signers",
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"request_id"
],
"additionalProperties": false
}