Skip to main content
Glama

catalog

by com.zaimhub
OverviewDiscussionsAdmin

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

get_category
Read-onlyIdempotent

Возвращает одну тематическую подборку (витрину) каталога по её slug (slug берите из list_categories): критерий попадания, порядок сортировки и полный список предложений МФО в ней. Slug может быть и витриной по сумме вида «zaim-10000-rubley» (страницы есть на каждую сумму от 1000 до 100000 рублей шагом 1000): тогда в подборке МФО, выдающие эту сумму новому клиенту, а top состоит из двух таблиц (best_value и max_term). Ответ: 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), или витрины по сумме вида «zaim-10000-rubley»

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
    • changedInput schema / properties / slug / description
      Previous value: -"Slug подборки, например «zaim-na-kartu»; берите из list_categories"New value: +"Slug подборки, например «zaim-na-kartu» (из list_categories), или витрины по сумме вида «zaim-10000-rubley»"
  2. 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"
+}
  3. 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"
+}
  4. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive, closed-world, so the bar is lower; the description goes well beyond by stating no auth, no side effects, a 60 req/min per-IP limit with HTTP 429 on breach, and explicit error behavior for a nonexistent slug (isError with 'Не найдено'). It also discloses the absence of pagination and an attribution requirement on canonical_url.

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?

Long but dense and front-loaded: purpose and slug sourcing come first, then return shape, then routing, then operational caveats. Nothing is recycled filler, though the inline JSON return-field enumeration is somewhat verbose given an output schema exists.

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 read tool with a rich output schema, the description supplies everything an agent needs: slug acquisition, alternate slug forms, return structure, sorting-table semantics ('берите их вместо собственной сортировки'), error handling, and rate limits. No gaps remain for correct invocation.

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?

One parameter with 100% schema coverage sets a baseline of 3, but the description adds real value beyond the schema: the special generated slug family for amounts (1000–100000 in 1000 steps) and the fact that such slugs change the response shape (top splits into best_value/max_term). That is semantic context the schema only hints at.

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?

Names a specific verb and resource ('Возвращает одну тематическую подборку каталога по её slug') and immediately distinguishes scope from siblings, noting slug comes from list_categories and that the resource can also be an amount-driven showcase ('zaim-10000-rubley'). An agent can tell exactly what this returns versus get_mfo or search_offers.

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 routing rules: use when the user's question matches the category theme (card loans, bad credit history, pensioners), use search_offers for amount/term searches, and get_mfo for single-lender detail. It also states the prerequisite (take the slug from list_categories), which is exactly the when-and-which guidance needed.

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