Skip to main content
Glama

catalog

by com.zaimhub
OverviewDiscussionsAdmin

Подборка займов по slug

get_category
Read-onlyIdempotent

Возвращает одну тематическую подборку (витрину) каталога по её slug (slug берите из list_categories): критерий попадания, порядок сортировки и полный список предложений МФО в ней. Ответ: JSON {title, slug, canonical_url, criterion, sorting, total, top, offers[]}, у каждого предложения: name, slug, amount_range, term_range, rate, rating_average и canonical_url карточки МФО. top — три автотаблицы витрины (условия для нового клиента, до 10 строк каждая, note и дата updated): best_value — беспроцентный первый займ по убыванию дней без процентов, max_amount — по максимальной сумме, max_term — по максимальному сроку; те же таблицы показаны на странице подборки, берите их вместо собственной сортировки. Постраничной навигации нет — возвращаются все МФО подборки. Используйте, когда вопрос пользователя совпадает с темой подборки (займ на карту, без отказа, с плохой кредитной историей, пенсионерам и т.п.); подбор по конкретной сумме или сроку — search_offers, подробности по одной МФО — get_mfo. Несуществующий slug → ответ с isError и текстом «Не найдено». Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). При использовании данных ссылайтесь на canonical_url.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugYesSlug подборки, например «zaim-na-kartu»; берите из list_categories

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
topNoАвтотаблицы «Топ-N …» витрины, те же, что на странице и в её .md-версии (до 10 строк каждая, условия для нового клиента)
slugYes
titleNo
totalYesЧисло МФО в подборке
offersNo
sortingNoПорядок сортировки
criterionNoКритерий попадания МФО в подборку
canonical_urlYesСтраница подборки на zaimhub.com

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / top
      Added value: +{
+  "additionalProperties": false,
+  "description": "Автотаблицы «Топ-N …» витрины, те же, что на странице и в её .md-версии (до 10 строк каждая, условия для нового клиента)",
+  "properties": {
+    "best_value": {
+      "additionalProperties": false,
+      "description": "Беспроцентный первый займ для нового клиента, по убыванию дней без процентов",
+      "properties": {
+        "criteria": {
+          "description": "Критерий отбора и сортировки",
+          "type": "string"
+        },
+        "rows": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "amount_to_rub": {
+                "description": "Максимальная сумма для нового клиента, ₽",
+                "type": "number"
+              },
+              "canonical_url": {
+                "format": "uri",
+                "type": "string"
+              },
+              "interest_free_days": {
+                "description": "Беспроцентный период для нового клиента, дней",
+                "type": "number"
+              },
+              "mfo": {
+                "type": "string"
+              },
+              "rank": {
+                "type": "number"
+              },
+              "rate_per_day_percent": {
+                "description": "% в день для нового клиента, 0 — первый займ под 0 %",
+                "type": "number"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "term_to_days": {
+                "description": "Максимальный срок для нового клиента, дней",
+                "type": "number"
+              }
+            },
+            "required": [
+              "rank",
+              "mfo",
+              "slug",
+              "canonical_url"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "title": {
+          "description": "Заголовок таблицы, как на странице («Топ-N …»)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "criteria",
+        "rows"
+      ],
+      "type": "object"
+    },
+    "max_amount": {
+      "additionalProperties": false,
+      "description": "По максимальной сумме для нового клиента",
+      "properties": {
+        "criteria": {
+          "description": "Критерий отбора и сортировки",
+          "type": "string"
+        },
+        "rows": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "amount_to_rub": {
+                "description": "Максимальная сумма для нового клиента, ₽",
+                "type": "number"
+              },
+              "canonical_url": {
+                "format": "uri",
+                "type": "string"
+              },
+              "interest_free_days": {
+                "description": "Беспроцентный период для нового клиента, дней",
+                "type": "number"
+              },
+              "mfo": {
+                "type": "string"
+              },
+              "rank": {
+                "type": "number"
+              },
+              "rate_per_day_percent": {
+                "description": "% в день для нового клиента, 0 — первый займ под 0 %",
+                "type": "number"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "term_to_days": {
+                "description": "Максимальный срок для нового клиента, дней",
+                "type": "number"
+              }
+            },
+            "required": [
+              "rank",
+              "mfo",
+              "slug",
+              "canonical_url"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "title": {
+          "description": "Заголовок таблицы, как на странице («Топ-N …»)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "criteria",
+        "rows"
+      ],
+      "type": "object"
+    },
+    "max_term": {
+      "additionalProperties": false,
+      "description": "По максимальному сроку для нового клиента",
+      "properties": {
+        "criteria": {
+          "description": "Критерий отбора и сортировки",
+          "type": "string"
+        },
+        "rows": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "amount_to_rub": {
+                "description": "Максимальная сумма для нового клиента, ₽",
+                "type": "number"
+              },
+              "canonical_url": {
+                "format": "uri",
+                "type": "string"
+              },
+              "interest_free_days": {
+                "description": "Беспроцентный период для нового клиента, дней",
+                "type": "number"
+              },
+              "mfo": {
+                "type": "string"
+              },
+              "rank": {
+                "type": "number"
+              },
+              "rate_per_day_percent": {
+                "description": "% в день для нового клиента, 0 — первый займ под 0 %",
+                "type": "number"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "term_to_days": {
+                "description": "Максимальный срок для нового клиента, дней",
+                "type": "number"
+              }
+            },
+            "required": [
+              "rank",
+              "mfo",
+              "slug",
+              "canonical_url"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "title": {
+          "description": "Заголовок таблицы, как на странице («Топ-N …»)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "criteria",
+        "rows"
+      ],
+      "type": "object"
+    },
+    "note": {
+      "description": "Что это за списки и как ими пользоваться",
+      "type": "string"
+    },
+    "updated": {
+      "description": "Дата изменения страницы, ГГГГ-ММ-ДД",
+      "type": "string"
+    }
+  },
+  "required": [
+    "note"
+  ],
+  "type": "object"
+}
  2. Changed2 schema fields changed
    • addedInput schema / properties / slug / description
      Added value: +"Slug подборки, например «zaim-na-kartu»; берите из list_categories"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "canonical_url": {
+      "description": "Страница подборки на zaimhub.com",
+      "format": "uri",
+      "type": "string"
+    },
+    "criterion": {
+      "description": "Критерий попадания МФО в подборку",
+      "type": "string"
+    },
+    "offers": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "amount_range": {
+            "type": "string"
+          },
+          "canonical_url": {
+            "format": "uri",
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "rate": {
+            "type": "string"
+          },
+          "rating_average": {
+            "type": "number"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "term_range": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "slug",
+          "canonical_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "slug": {
+      "type": "string"
+    },
+    "sorting": {
+      "description": "Порядок сортировки",
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    },
+    "total": {
+      "description": "Число МФО в подборке",
+      "type": "number"
+    }
+  },
+  "required": [
+    "slug",
+    "canonical_url",
+    "total"
+  ],
+  "type": "object"
+}
  3. First observed

TDQS

A4.9/5.0
Behavior5/5

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

Beyond the annotations (readOnly, idempotent, non-destructive), the description discloses no pagination (returns all), a rate limit of 60 req/min with HTTP 429, an error response shape for non-existent slug (isError + 'Не найдено'), and a requirement to reference canonical_url when using data. It also explains the 'top' tables and instructs to use them instead of own sorting. No contradiction with annotations.

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

Conciseness5/5

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

The description is substantial but every sentence contributes: purpose, response structure, 'top' details, usage guidance, error handling, rate limit, and attribution. It is front-loaded with the core purpose, then expands logically. There is no fluff or redundancy.

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 single-parameter tool with a rich output, the description fully covers the response shape, error handling, rate limits, and usage conditions. It also explains the 'top' tables in detail, ensuring the agent knows exactly what to expect and how to use the data. Nothing critical is missing.

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

Parameters4/5

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

Schema coverage is 100% and the schema already describes the 'slug' parameter with an example. The description adds crucial context that the slug should be taken from list_categories, which is not in the schema, and reinforces the format. This extra guidance elevates it above the baseline 3 for full coverage.

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 states a specific verb ('Возвращает') and resource ('тематическую подборку каталога') with its key attributes (критерий, сортировка, список предложений). It distinguishes itself from siblings by naming search_offers and get_mfo as alternatives for other intents, making the tool's scope unambiguous.

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?

Explicitly specifies when to use this tool: when the user's question matches a category topic, with concrete examples (займ на карту, без отказа, etc.). It also states when not to use it and what to use instead (search_offers for specific sum/term, get_mfo for single MFO details), and instructs to obtain slug from list_categories. No ambiguity.

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

All catalog toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources