Catalog MCP Server

Повна картка однієї МФО за slug: умови для нового і повторного клієнта з тарифів, тими самими рядками, що на картці сайту (conditions = тариф, який картка показує без фільтра: назва тарифу, сума, строк, ставка, комісія за видачу, реальна річна ставка; tariffs = усі тарифи нового і повторного клієнта з платежами; tariffs: null = у МФО ще немає тарифів, тоді conditions зі старого блоку пропозиції), перший кредит без нарахування відсотків перші N днів (first_loan_zero_percent: true/false/null, null = даних немає; first_loan_promo_days = кількість днів, first_loan_promo_condition = умова акції, first_loan_promo_tariff = тариф з акцією; береться з тарифів, як на картці сайту; лише для нового клієнта, це не пільговий період), вимоги до позичальника, юридична особа, ліцензія НБУ, посилання на офіційні документи, рейтинг за 4 критеріями і дата актуалізації. Використовуйте, коли компанія вже відома; slug беріть із list_mfo або search_offers. Для відгуків словами — get_reviews, для порівняння кількох МФО — search_offers або get_category. Read-only, без авторизації, ліміт 60 запитів/хв. Невідомий slug → відповідь-помилка з підказкою, а не порожній результат. rating: null = відгуків ще немає. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Повний список МФО каталогу (усі компанії з ліцензією НБУ) з рейтингом позичальників, кількістю відгуків і canonical_url картки кожної. Використовуйте, щоб отримати slug для get_mfo/get_reviews або дати огляд ринку; для підбору під суму і строк беріть search_offers, для тематичних добірок — list_categories. Read-only, без авторизації, ліміт 60 запитів/хв. Повертає весь список однією відповіддю без пагінації, у порядку рейтингу сайту (поля criterion і sorting пояснюють порядок). rating: null означає «відгуків ще немає», а не низьку оцінку (поруч rating_status: no_reviews_yet). Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Перелік тематичних добірок каталогу двома групами: кредитні (корінь сайту, напр. kredit-na-kartu) і позикові (розділ /loan/, напр. pozyka-na-kartku) плюс хаб позик; для кожної — назва, критерій добірки і canonical_url. Використовуйте, щоб знайти slug для get_category або відповісти, які тематичні підбірки існують; списку МФО тут немає — по ньому list_mfo, за числовими умовами — search_offers. Read-only, без авторизації, ліміт 60 запитів/хв. Одна відповідь без пагінації. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Одна тематична добірка за slug: критерій відбору, порядок сортування, таблиця МФО з умовами (сума, строк, ставка, реальна річна ставка) та canonical_url і markdown_url сторінки. Використовуйте, коли запит збігається з готовою редакційною добіркою («кредит на картку», «позика без відмови»); slug беріть із list_categories. Для підбору за числами — search_offers, для деталей однієї МФО — get_mfo, для переліку всіх добірок — list_categories. Read-only, без авторизації, ліміт 60 запитів/хв. Поле top — готові добірки з цієї ж сторінки (best_value: ставка не вище 0,01% на день і комісія за видачу 0; max_amount — за максимальною сумою; max_term — за максимальним строком), до 10 позицій кожна, лише умови нового клієнта — беріть їх замість власного сортування. Невідомий slug → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Витрина області або міста за slug: без параметра city — сторінка області (перелік її міст зі slug і canonical_url плюс таблиця МФО області з умовами: сума, строк, ставка, реальна річна ставка), з city — сторінка міста (ті самі МФО області, canonical_url і markdown_url сторінки з текстом і відповідями на часті питання). Використовуйте для запитів на кшталт «кредит у Львові» чи «МФО Одеської області»; slug області беріть із list_regions, slug міста — з відповіді get_city по області. Для підбору за сумою і строком у регіоні — search_offers з параметром region, для деталей однієї МФО — get_mfo. Read-only, без авторизації, ліміт 60 запитів/хв. Поле top — готові добірки з цієї ж сторінки (best_value: ставка не вище 0,01% на день і комісія за видачу 0; max_amount — за максимальною сумою; max_term — за максимальним строком), до 10 позицій кожна, лише умови нового клієнта — беріть їх замість власного сортування. Київ — регіон-місто: get_city з region=kyiv одразу повертає витрину міста. Невідома область чи місто → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Правовий контекст мікрокредитування в Україні (довідка, не юридична консультація): гранична ставка 1% на день (Закон 3498-IX), обов'язкова оцінка кредитоспроможності (ст. 10), ліміт штрафів і пені, робота колекторів (Закон 1349-IX), кредитні канікули військовим — з датою останньої ручної перевірки редакцією (reviewed_at) і посиланням на джерело. Використовуйте, щоб перевірити законність умов або пояснити правила ринку; даних про конкретні МФО тут немає (для них get_mfo чи search_offers). Read-only, без авторизації, ліміт 60 запитів/хв. Статичний текст, однаковий для всіх запитів. Норми — лише українською (canonical); lang впливає тільки на поле note. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Підбір пропозицій під запит клієнта з розрахунком суми повернення: відбирає МФО, у яких тариф ПЕРШОГО кредиту (новий клієнт) дає бажану суму (грн), а бажаний строк (днів) не довший за договір; опційно — лише з першим кредитом без нарахування відсотків перші N днів і лише в певній області (region). Строк, коротший за договір, проходить як дострокове повернення (кредит можна закрити будь-якого дня), тому договори на 360 – 365 днів не відсікаються. Для кожної МФО повертає тариф, діапазони суми і строку договору, ставку (rate_text, як на картці сайту), комісію за видачу, реальну річну ставку і calculation: repayment_total_uah — орієнтовна сума повернення на запитані суму і строк (те саме число «Усього виплатите», що на картці; без суми чи строку рахується приклад 5000 грн на 30 днів, is_example: true), overpayment_uah, early_repayment, upper_bound (true = «до», узято найбільші комісії з вилки документа), promo_applied, promo_condition (by_assessment — після оцінки МФО, on_time — за умови платежів вчасно) і repayment_total_without_promo_uah. first_loan_zero_percent (true/false/null) — ознака МФО: є тариф нового клієнта з акцією не вище 0,01% на день (first_loan_promo_days, first_loan_promo_tariff); під запит картка може показати інший тариф, чи увійшла акція в розрахунок — у calculation.promo_applied. Використовуйте для запитів на кшталт «де взяти 5000 грн на 30 днів і скільки повертати» або «кредит 3000 грн у Львові»; для повного списку без умов — list_mfo, для деталей однієї МФО — get_mfo, для сторінки області чи міста — get_city. Read-only, без авторизації, ліміт 60 запитів/хв. Фільтри незалежні й поєднуються через «І»; без фільтрів повертає весь каталог. Порядок — як у рейтингу сайту, не за ціною: щоб знайти найдешевшу, порівняйте repayment_total_uah. region — slug області з list_regions: у видачу потрапляють лише МФО, що видають кредит у цій області; невідомий region → відповідь-помилка. limit (типово 15, максимум 50) обрізає видачу: total — повне число збігів, truncated: true — є ще. Суми орієнтовні, остаточну суму визначає договір з МФО. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Перелік областей України та міста Київ, для яких на сайті є витрини «кредит онлайн у вашому місті»: для кожного регіону — назва, кількість міст, кількість МФО, що видають кредит у цьому регіоні, canonical_url і markdown_url сторінки. Використовуйте, щоб знайти slug області для get_city або для параметра region у search_offers, чи щоб відповісти, у яких регіонах є пропозиції; переліку міст тут немає — його повертає get_city без параметра city. МФО прив'язані до області, тому перелік компаній однаковий для всіх міст однієї області; Київ — окрема витрина міста (is_city: true). Read-only, без авторизації, ліміт 60 запитів/хв. Одна відповідь без пагінації; mfos_count: 0 означає, що жодна МФО ще не позначила регіон. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

Останні відгуки позичальників про одну МФО за slug: оцінка 1–5, дата, текст, ім'я автора (лише те, що публічно на сайті) і total — загальна кількість відгуків. Використовуйте після get_mfo, коли потрібна думка клієнтів словами; для середньої оцінки достатньо get_mfo або list_mfo. Read-only, без авторизації, ліміт 60 запитів/хв. Повертає до limit найновіших (типово і максимум 10, без пагінації); МФО без відгуків → порожній список і total: 0; невідомий slug → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.