Skip to main content
Glama

search_offers

Подбор МФО под запрос заёмщика по сумме, сроку и признаку «первый микрокредит под 0,01%». Фильтрует условия для новых клиентов: МФО попадает в ответ, если запрошенные сумма и срок входят в её диапазоны; без фильтров возвращает весь каталог. Порядок — по позиции в рейтинге. Возвращает query, total (сколько МФО подошло всего), truncated (true, если вернули не всех — увеличьте limit) и offers: name, slug, диапазоны суммы и срока, ставка, interest_free_days, first_loan_zero_percent (true/false/null, null = не подтверждено), rating_average, canonical_url. Пустой offers при total 0 означает, что под фильтры никто не подошёл — ослабьте сумму или срок. Используйте для вопросов «где взять N тенге на M дней»; готовые тематические подборки — get_category, карточка одной МФО — get_mfo. Условия волатильны, финальные — на canonical_url.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoМаксимум предложений в ответе, от 1 до 100. По умолчанию 15. Если в ответе truncated = true, повторите запрос с большим limit.
amountNoЖелаемая сумма микрокредита в тенге (₸), целое число не меньше 1, например 100000. Без параметра сумма не фильтруется.
term_daysNoЖелаемый срок в календарных днях, целое число не меньше 1, например 30. Без параметра срок не фильтруется.
first_loan_zeroNotrue — оставить только МФО с подтверждённым первым микрокредитом под 0,01% (есть льготные дни или нулевая ставка для новых клиентов). false или отсутствие — не фильтровать по этому признаку.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed4 schema fields changed
    • addedInput schema / properties / amount / description
      Added value: +"Желаемая сумма микрокредита в тенге (₸), целое число не меньше 1, например 100000. Без параметра сумма не фильтруется."
    • addedInput schema / properties / first_loan_zero / description
      Added value: +"true — оставить только МФО с подтверждённым первым микрокредитом под 0,01% (есть льготные дни или нулевая ставка для новых клиентов). false или отсутствие — не фильтровать по этому признаку."
    • addedInput schema / properties / limit / description
      Added value: +"Максимум предложений в ответе, от 1 до 100. По умолчанию 15. Если в ответе truncated = true, повторите запрос с большим limit."
    • addedInput schema / properties / term_days / description
      Added value: +"Желаемый срок в календарных днях, целое число не меньше 1, например 30. Без параметра срок не фильтруется."
  2. First observed

TDQS

A4.8/5.0
Behavior5/5

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

No annotations are provided, so the description carries the full burden. It discloses key behavioral traits: ordering by rating, unfiltered behavior returning the entire catalog, truncation semantics, the meaning of total=0 with empty offers, the null meaning of first_loan_zero_percent, and volatility of conditions.

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 but well-structured: purpose, matching behavior, response fields, empty-result guidance, usage guidance, and caveat. It could be slightly tightened, but every section earns its place.

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?

With no output schema and no annotations, the description fully enumerates the response shape (query, total, truncated, offers fields), explains edge cases like total=0 and truncated=true, and provides usage and caveat context. Nothing essential for correct invocation 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%, so the baseline is 3. The description adds valuable meaning beyond the schema by explaining how filters interact: an MFI matches only if requested amount and term fall within its ranges, and an empty offers result with total=0 should trigger relaxing the filters.

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 clearly states the tool's function: selecting MFIs by borrower request based on amount, term, and first-loan-zero flag. It also distinguishes itself from siblings by naming get_category for ready thematic collections and get_mfo for a single MFI card.

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?

The description explicitly says when to use the tool ('where to get N tenge for M days') and names alternatives with their contexts (get_category for curated selections, get_mfo for a single MFI card). This is strong routing guidance for an agent.

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.