garant-mcp

Overview Schema Source Related Servers Score Discussions Admin

garant_document

Retrieve the complete text of a Russian legal document by ID, including revision, date, and hash. Use for full acts; specify max_pages for long documents.

Instructions

Полный текст документа по doc_id + provenance (редакция, дата актуальности, hash).

Использовать, когда нужен весь акт. Для одной статьи/пункта — garant_article (дешевле и точнее).

Полноту проверяют сравнением: страниц — сколько загружено, страниц_в_документе — сколько их всего (null, если «Гарант» числа не назвал). Расходятся — ответ несёт _предупреждение, и в нём названа причина: упёрлись в max_pages (повтор с бо́льшим значением помогает) или «Гарант» не отдал пакет страниц (не помогает, смотрите логи).

max_pages — сколько страниц загружать. Параметр выставлен наружу потому, что на длинном акте ответ несёт _предупреждение с советом увеличить max_pages: совет, которому нельзя последовать, хуже отсутствия совета. Не указан — берётся умолчание клиента; второго его написания здесь нет намеренно, оно разошлось бы с первым молча.

_нормализация — присутствует ВСЕГДА, как и у garant_article: текст получен нормализацией HTML страницы «Гаранта», а не выгрузкой оригинала, и редакционные врезки могли попасть в него неотмеченными. Обещание «полный текст» относится к охвату страниц, а не к дословности разметки. Что именно нормализация ставит в тексте и что в нём меняет, перечислено в самом ключе _нормализация каждого ответа; второго его написания здесь нет намеренно: оно разошлось бы с первым молча — и разошлось бы там, где читатель переносит цитату в подаваемый документ.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`doc_id`	Yes
`max_pages`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedv0.1.0Sep 8, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations available, the description carries the full burden of behavioral disclosure and does so thoroughly: it exposes the always-present `_нормализация`, the caveat that 'полный текст' means page coverage rather than verbatim markup, the provenance fields, and the exact meaning of `_предупреждение` in both failure modes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose and remains dense throughout, but the same 'второго его написания здесь нет намеренно' explanation appears twice and some meta-commentary could be tightened. Still, the length is justified by the tool's complexity and the absence of annotations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a two-parameter tool with an output schema, the description covers purpose, alternatives, parameter semantics, response keys (`страниц`, `страниц_в_документе`, `_предупреждение`, `_нормализация`), and edge-case behavior. Nothing an agent needs to decide whether to call this tool is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must explain the parameters. It clearly ties doc_id to the target document and gives max_pages a full treatment: what it controls, why it was exposed, what happens when omitted, and why a second prose copy was deliberately avoided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Полный текст документа по doc_id + provenance', clearly stating it returns the full act text plus editorial metadata. It also distinguishes itself from garant_article by positioning this tool as the one to use when the whole act is needed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly states when to use the tool ('Использовать, когда нужен весь акт') and names the alternative for a single article/punkt ('Для одной статьи/пункта — garant_article (дешевле и точнее)'). It also explains how to react to the warning conditions, including retrying with a larger max_pages.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server