Skip to main content
Glama

find_advisor

Read-onlyIdempotent

Use this when the user described a task/problem but has not chosen an advisor yet («кто поможет», «с чего начать», бизнес-задача без имени методики). After this tool, call ask_advisor with a slug from the response. Подбор советника под задачу. Возвращает best_matches (может быть пусто) и catalog до 120 карточек; лучшие совпадения включены первыми. catalog: tasks, pick_when, not_for. Выбирай по tasks/pick_when; если нужен выбор цели — ОДИН разводящий вопрос по not_for, не меню имён. private_advisors — личные советники пользователя, доступные только ему; выбирай их наравне с каталогом, передавая slug в ask_advisor. Slug для ask_advisor — только из ответа. how_to_work — режимы/эстафеты/линзы; следуй ей.

Input Schema

NameRequiredDescriptionDefault
goalNoЧто должно произойти в результате (опционально; участвует в поиске наравне с task и context).
taskYesЗадача пользователя дословно: что нужно сделать / какую ситуацию разобрать. Обязательное поле.
contextNoКраткий контекст: роль, отрасль, ограничения (опционально).

Output Schema

NameRequiredDescriptionDefault
noteYes
catalogYes
how_to_workYes
best_matchesYes
private_advisorsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / private_advisors
      Added value: +{
      +  "items": {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "access": {
      +            "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +            "enum": [
      +              "available",
      +              "needs_subscription",
      +              "needs_purchase"
      +            ],
      +            "type": "string"
      +          },
      +          "author": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "category": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "not_for": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "pick_when": {
      +            "type": "string"
      +          },
      +          "slug": {
      +            "type": "string"
      +          },
      +          "tasks": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "slug",
      +          "title",
      +          "author",
      +          "access",
      +          "tasks",
      +          "pick_when",
      +          "not_for"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "access": {
      +            "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +            "enum": [
      +              "available",
      +              "needs_subscription",
      +              "needs_purchase"
      +            ],
      +            "type": "string"
      +          },
      +          "author": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "category": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "slug": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "slug",
      +          "title",
      +          "author",
      +          "access",
      +          "description"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
  2. Changed3 schema fields changed
    • changedInput schema / properties / goal / description
      Previous value: -"Что должно произойти в результате (опционально; помогает ранжированию косвенно через формулировку task)."New value: +"Что должно произойти в результате (опционально; участвует в поиске наравне с task и context)."
    • changedOutput schema / properties / best_matches / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_for": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "pick_when": {
      -        "type": "string"
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "tasks": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "why_great": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "tasks",
      -      "pick_when",
      -      "not_for",
      -      "why_great"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "why_great": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "description",
      -      "why_great"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "category": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_for": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pick_when": {
      +        "type": "string"
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "tasks": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "why_great": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "tasks",
      +      "pick_when",
      +      "not_for",
      +      "why_great"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "category": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "why_great": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "description",
      +      "why_great"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / catalog / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_for": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "pick_when": {
      -        "type": "string"
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "tasks": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "tasks",
      -      "pick_when",
      -      "not_for"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "description"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "category": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_for": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pick_when": {
      +        "type": "string"
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "tasks": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "tasks",
      +      "pick_when",
      +      "not_for"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "category": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "description"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed5 schema fields changed
    • addedInput schema / properties / context / maxLength
      Added value: +15000
    • addedInput schema / properties / goal / maxLength
      Added value: +15000
    • addedInput schema / properties / task / maxLength
      Added value: +4000
    • changedOutput schema / properties / best_matches / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_for": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "pick_when": {
      -        "type": "string"
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "tasks": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "why_great": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "tasks",
      -      "pick_when",
      -      "not_for",
      -      "why_great"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "why_great": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "description",
      -      "why_great"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_for": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pick_when": {
      +        "type": "string"
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "tasks": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "why_great": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "tasks",
      +      "pick_when",
      +      "not_for",
      +      "why_great"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "why_great": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "description",
      +      "why_great"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / catalog / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_for": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "pick_when": {
      -        "type": "string"
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "tasks": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "tasks",
      -      "pick_when",
      -      "not_for"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "access": {
      -        "enum": [
      -          "available",
      -          "needs_subscription",
      -          "needs_purchase"
      -        ],
      -        "type": "string"
      -      },
      -      "author": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "slug": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "slug",
      -      "title",
      -      "author",
      -      "access",
      -      "description"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_for": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "pick_when": {
      +        "type": "string"
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "tasks": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "tasks",
      +      "pick_when",
      +      "not_for"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access": {
      +        "description": "Право на советника. available не гарантирует отправку сейчас: действуют лимиты сообщений и токенов; my_access показывает правила лимитов.",
      +        "enum": [
      +          "available",
      +          "needs_subscription",
      +          "needs_purchase"
      +        ],
      +        "type": "string"
      +      },
      +      "author": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "slug": {
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "slug",
      +      "title",
      +      "author",
      +      "access",
      +      "description"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "best_matches": {
      +      "items": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "access": {
      +                "enum": [
      +                  "available",
      +                  "needs_subscription",
      +                  "needs_purchase"
      +                ],
      +                "type": "string"
      +              },
      +              "author": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_for": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "pick_when": {
      +                "type": "string"
      +              },
      +              "slug": {
      +                "type": "string"
      +              },
      +              "tasks": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "why_great": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "title",
      +              "author",
      +              "access",
      +              "tasks",
      +              "pick_when",
      +              "not_for",
      +              "why_great"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "access": {
      +                "enum": [
      +                  "available",
      +                  "needs_subscription",
      +                  "needs_purchase"
      +                ],
      +                "type": "string"
      +              },
      +              "author": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "description": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "slug": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "why_great": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "title",
      +              "author",
      +              "access",
      +              "description",
      +              "why_great"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "maxItems": 5,
      +      "type": "array"
      +    },
      +    "catalog": {
      +      "items": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "access": {
      +                "enum": [
      +                  "available",
      +                  "needs_subscription",
      +                  "needs_purchase"
      +                ],
      +                "type": "string"
      +              },
      +              "author": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "not_for": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "pick_when": {
      +                "type": "string"
      +              },
      +              "slug": {
      +                "type": "string"
      +              },
      +              "tasks": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "title",
      +              "author",
      +              "access",
      +              "tasks",
      +              "pick_when",
      +              "not_for"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "access": {
      +                "enum": [
      +                  "available",
      +                  "needs_subscription",
      +                  "needs_purchase"
      +                ],
      +                "type": "string"
      +              },
      +              "author": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "description": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "slug": {
      +                "type": "string"
      +              },
      +              "title": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "title",
      +              "author",
      +              "access",
      +              "description"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "maxItems": 120,
      +      "type": "array"
      +    },
      +    "how_to_work": {
      +      "type": "string"
      +    },
      +    "note": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "best_matches",
      +    "catalog",
      +    "note",
      +    "how_to_work"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false, so the safety profile is covered. The description adds genuinely behavioral context beyond that: best_matches may be empty, matches are ordered best-first, catalog caps at 120 cards, and the slug passed to ask_advisor must come only from this response. Some of this overlaps the output schema, but the empty-result case and slug-sourcing constraint are real behavioral disclosure.

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 dense and mixes English and Russian, but every sentence carries information and the usage trigger is front-loaded ahead of the return-format and follow-up details. It is packed rather than padded, though the language switching slightly hurts readability.

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

Completeness4/5

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

Given an output schema exists and annotations cover safety, the description still goes further by explaining the discovery flow, the private_advisors field's scope, how_to_work usage, and the slug hand-off to ask_advisor. Nothing essential for correct invocation appears missing; only minor details like catalog selection tie-breaking at scale are unaddressed.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents task, goal, and context fully – including the required/optional distinction. The description adds only marginal semantics ('goal participates in search on par with task and context'), which does not materially extend what the schema provides. Baseline 3 is appropriate.

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?

States a specific verb+resource ('Подбор советника под задачу' / find an advisor for the task) and front-loads a precise trigger: the user described a task but has not chosen an advisor. It also distinguishes the flow from siblings by explicitly routing to ask_advisor next and warning against presenting a 'menu of names' (which contrasts with list_advisors).

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?

Explicit when-to-use ('user described a task/problem but has not chosen an advisor yet', with concrete Russian trigger phrases), the required follow-up (call ask_advisor with a slug from the response), and a behavioral rule for ambiguous cases (ask ONE disambiguating question via not_for, not a list of names). Nothing is left to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources