3. Описание MCP-сервера › 3.5 AI-инструменты › tool_list

Отдаёт AI-инструменты магазина: список всех или один инструмент целиком — с каждой командой и её полями.

Право

«Инструменты → Получить список» (AGENT_TOOL_LIST).

Параметры

Параметр Тип Что это
[unit] строка адрес инструмента, как его даёт список: MELBIS_AGENT_CURRENCY. Без него — список всех

Ответ

Без unit:

{"grant": "Проектирование -> AI-компоненты",
 "tools": {"columns": ["unit", "path", "descr", "may", "also"],
           "rows": [["MELBIS_AGENT_TASK", "Business -> Scheduler",
                     "The scheduler of the program: the tasks and the feed of notes under every one of them.",
                     ["CmdList", "CmdAdd", "CmdNoteList", "CmdNoteAdd"], []]]}}
Поле Что это
grant где в программе заводят инструменты и выдают права на их команды
tools инструменты: unit — адрес, path — место в дереве AI-инструментов, descr — описание до 160 символов, длинное обрезано по концу фразы, may — выданные команды, also — остальные

Если инструментов в магазине нет, rows пустой, а вторым блоком идёт This store has no AI-tools of its own yet… с окном и вкладкой программы, где их заводят.

С unit:

{"unit": "MELBIS_AGENT_TASK", "path": "Business -> Scheduler",
 "descr": "The scheduler of the program…",
 "commands": [{"name": "CmdAdd", "may": true,
               "descr": "Adds a task and opens its feed with the first note…",
               "params": {"columns": ["name", "type", "required", "default", "descr"],
                          "rows": [["name", "str", true, "", "one line of what to do"],
                                   ["kind_key", "str", false, "kDefault", "a value of TASK_KIND_KEY"]]},
               "files": null}]}
Поле Что это
unit, path адрес и место в дереве
descr описание инструмента целиком
commands команды: name, may — выдана ли этому логину, descr — описание, params — поля команды, files — принимает ли вложения
params поля: name, type, required — обязательное ли, default — значение по умолчанию, descr
files null, если команда вложений не принимает; иначе required и descr

Отказы

Ответ Когда
ACCESS_DENIED: no such tool: <unit> инструмента с таким адресом нет в реестре

Общие отказы — «Ответы и отказы».