# MCP: legal

Source: <https://telegafirst.com/docs/mcp-legal>
Locale: ru
releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7
sourceContentDigest: 96938edd0616e26b9a7a11c021ad67819ed1e0bc6646d0e7836fe8a601947c88
Version: 1

# MCP: legal

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required\_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load\_domain/describe\_tool и существующий meta-dispatch описаны в [MCP-руководстве](https://telegafirst.com/docs/mcp-guide). [Scopes и права](https://telegafirst.com/docs/scopes-and-permissions) применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

## get\_legal\_profile

Read the tenant legal / fiscalization profile: the РФ (54-ФЗ) block (legal name, ИНН, ОГРН, taxation system, default VAT) + the World block (legal name, tax id, country, default tax rate), plus `ru_zone_activated` / `world_zone_activated` flags. OWNER-ONLY. 0-cost read.

```json
{
  "description": "Read the tenant legal / fiscalization profile: the РФ (54-ФЗ) block (legal name, ИНН, ОГРН, taxation system, default VAT) + the World block (legal name, tax id, country, default tax rate), plus `ru_zone_activated` / `world_zone_activated` flags. OWNER-ONLY. 0-cost read.",
  "domain": "legal",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "get_legal_profile",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "legal:read"
  ],
  "risk": "read",
  "scope": "legal:read",
  "title": "Get Legal Profile"
}
```

## update\_legal\_profile

Update the tenant legal / fiscalization profile (partial patch — send only the fields you change; pass null to clear one). Supplying `ru_inn` activates the РФ payment zone; `world_tax_id` activates the World zone. Idempotent. OWNER-ONLY (54-ФЗ). Returns the full updated profile.

```json
{
  "description": "Update the tenant legal / fiscalization profile (partial patch — send only the fields you change; pass null to clear one). Supplying `ru_inn` activates the РФ payment zone; `world_tax_id` activates the World zone. Idempotent. OWNER-ONLY (54-ФЗ). Returns the full updated profile.",
  "domain": "legal",
  "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"
      },
      "ru_business_type": {
        "anyOf": [
          {
            "description": "Value for ru business type option.",
            "maxLength": 64,
            "type": "string"
          },
          {
            "description": "Value for ru business type option.",
            "type": "null"
          }
        ],
        "description": "Value for ru business type."
      },
      "ru_contact_email": {
        "anyOf": [
          {
            "description": "Value for ru contact email option.",
            "format": "email",
            "maxLength": 256,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          {
            "description": "Value for ru contact email option.",
            "type": "null"
          }
        ],
        "description": "Value for ru contact email."
      },
      "ru_contact_phone": {
        "anyOf": [
          {
            "description": "Value for ru contact phone option.",
            "maxLength": 64,
            "type": "string"
          },
          {
            "description": "Value for ru contact phone option.",
            "type": "null"
          }
        ],
        "description": "Value for ru contact phone."
      },
      "ru_default_price_includes_tax": {
        "anyOf": [
          {
            "description": "Value for ru default price includes tax option.",
            "type": "boolean"
          },
          {
            "description": "Value for ru default price includes tax option.",
            "type": "null"
          }
        ],
        "description": "Value for ru default price includes tax."
      },
      "ru_default_vat_rate": {
        "anyOf": [
          {
            "description": "Value for ru default vat rate option.",
            "enum": [
              "none",
              "vat_0",
              "vat_5",
              "vat_7",
              "vat_10",
              "vat_20",
              "vat_22"
            ],
            "type": "string"
          },
          {
            "description": "Value for ru default vat rate option.",
            "type": "null"
          }
        ],
        "description": "Value for ru default vat rate."
      },
      "ru_inn": {
        "anyOf": [
          {
            "description": "Value for ru inn option.",
            "maxLength": 12,
            "type": "string"
          },
          {
            "description": "Value for ru inn option.",
            "type": "null"
          }
        ],
        "description": "Value for ru inn."
      },
      "ru_legal_address": {
        "anyOf": [
          {
            "description": "Value for ru legal address option.",
            "maxLength": 512,
            "type": "string"
          },
          {
            "description": "Value for ru legal address option.",
            "type": "null"
          }
        ],
        "description": "Value for ru legal address."
      },
      "ru_legal_name": {
        "anyOf": [
          {
            "description": "Value for ru legal name option.",
            "maxLength": 256,
            "type": "string"
          },
          {
            "description": "Value for ru legal name option.",
            "type": "null"
          }
        ],
        "description": "Value for ru legal name."
      },
      "ru_ogrn": {
        "anyOf": [
          {
            "description": "Value for ru ogrn option.",
            "maxLength": 15,
            "type": "string"
          },
          {
            "description": "Value for ru ogrn option.",
            "type": "null"
          }
        ],
        "description": "Value for ru ogrn."
      },
      "ru_taxation_system": {
        "anyOf": [
          {
            "description": "Value for ru taxation system option.",
            "enum": [
              "osn",
              "usn_income",
              "usn_income_outcome",
              "esn",
              "patent"
            ],
            "type": "string"
          },
          {
            "description": "Value for ru taxation system option.",
            "type": "null"
          }
        ],
        "description": "Value for ru taxation system."
      },
      "world_business_type": {
        "anyOf": [
          {
            "description": "Value for world business type option.",
            "maxLength": 64,
            "type": "string"
          },
          {
            "description": "Value for world business type option.",
            "type": "null"
          }
        ],
        "description": "Value for world business type."
      },
      "world_contact_email": {
        "anyOf": [
          {
            "description": "Value for world contact email option.",
            "format": "email",
            "maxLength": 256,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          {
            "description": "Value for world contact email option.",
            "type": "null"
          }
        ],
        "description": "Value for world contact email."
      },
      "world_country": {
        "anyOf": [
          {
            "description": "Value for world country option.",
            "maxLength": 8,
            "type": "string"
          },
          {
            "description": "Value for world country option.",
            "type": "null"
          }
        ],
        "description": "Value for world country."
      },
      "world_default_price_includes_tax": {
        "anyOf": [
          {
            "description": "Value for world default price includes tax option.",
            "type": "boolean"
          },
          {
            "description": "Value for world default price includes tax option.",
            "type": "null"
          }
        ],
        "description": "Value for world default price includes tax."
      },
      "world_default_tax_rate_percent": {
        "anyOf": [
          {
            "description": "Value for world default tax rate percent option.",
            "maximum": 999,
            "minimum": 0,
            "type": "number"
          },
          {
            "description": "Value for world default tax rate percent option.",
            "type": "null"
          }
        ],
        "description": "Value for world default tax rate percent."
      },
      "world_legal_name": {
        "anyOf": [
          {
            "description": "Value for world legal name option.",
            "maxLength": 256,
            "type": "string"
          },
          {
            "description": "Value for world legal name option.",
            "type": "null"
          }
        ],
        "description": "Value for world legal name."
      },
      "world_registered_address": {
        "anyOf": [
          {
            "description": "Value for world registered address option.",
            "maxLength": 512,
            "type": "string"
          },
          {
            "description": "Value for world registered address option.",
            "type": "null"
          }
        ],
        "description": "Value for world registered address."
      },
      "world_state": {
        "anyOf": [
          {
            "description": "Value for world state option.",
            "maxLength": 64,
            "type": "string"
          },
          {
            "description": "Value for world state option.",
            "type": "null"
          }
        ],
        "description": "Value for world state."
      },
      "world_tax_id": {
        "anyOf": [
          {
            "description": "Value for world tax id option.",
            "maxLength": 64,
            "type": "string"
          },
          {
            "description": "Value for world tax id option.",
            "type": "null"
          }
        ],
        "description": "Value for world tax id."
      }
    },
    "type": "object"
  },
  "name": "update_legal_profile",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "legal:write"
  ],
  "risk": "write",
  "scope": "legal:write",
  "title": "Update Legal Profile"
}
```