MFOXA — Ukraine Microfinance Catalog (MCP Server)

Public read-only Model Context Protocol server for the catalog of licensed Ukrainian microfinance organizations (MFOs), powered by mfoxa.com.ua — МФОХА, a Ukrainian MFO comparison marketplace.


Endpoint	`https://mfoxa.com.ua/api/mcp`
Transport	Streamable HTTP (stateless)
Authentication	none (public data)
Registry	`ua.com.mfoxa/catalog` (official MCP Registry, domain-verified)
Server card	`/.well-known/mcp/server-card.json`
Languages	Ukrainian (`uk`, default) and Russian (`ru`) via the `lang` parameter
Rate limit	60 requests/min per IP → HTTP 429

Every entity in every response carries a canonical_url pointing to the live page on mfoxa.com.ua.

Tools

Tool	Parameters	Returns
`list_mfo`	`lang?`	All MFOs with borrower rating and canonical card URLs. `rating: null` means no reviews yet, not a low score.
`get_mfo`	`slug`, `lang?`	Full MFO card: terms for new/repeat clients (amount, term, rate), effective annual rate, legal entity, NBU license, official disclosure PDFs, 4-criteria rating, record update date.
`search_offers`	`amount?`, `term_days?`, `first_loan_zero?`, `limit?` (default 15), `lang?`	Matching first-loan offers with terms, `first_loan_zero_percent: true/false/null` (null = unconfirmed), honest `total` + `truncated`.
`list_categories`	`lang?`	Catalog categories in two separate groups — credit (site root) and loan (`/loan/`) — each with its selection criterion.
`get_category`	`slug`, `lang?`	One category: criterion, sorting, offer table with per-MFO terms.
`get_reviews`	`slug`, `limit?` (≤10), `lang?`	Latest borrower reviews for an MFO: rating, date, text.
`get_market_rules`	`lang?`	Legal context of microlending in Ukraine (1%/day rate cap under Law 3498-IX, mandatory creditworthiness assessment, penalty caps, debt collection rules, military credit holidays) with last-review date. Legal facts are maintained in Ukrainian only.

Resources: llms.txt and llms-full.txt.

Installation

Claude (claude.ai / Claude Desktop)

Settings → Connectors → Add custom connector
Name: MFOXA catalog, URL: https://mfoxa.com.ua/api/mcp
Save. No API keys or OAuth — the server is public and read-only.

Any MCP client (generic)

Point your client at the remote Streamable HTTP endpoint:

config.json

{
  "mcpServers": {
    "mfoxa-catalog": {
      "type": "streamable-http",
      "url": "https://mfoxa.com.ua/api/mcp"
    }
  }
}

Quick sanity check with MCP Inspector:

Terminal

npx @modelcontextprotocol/inspector --cli https://mfoxa.com.ua/api/mcp --transport http --method tools/list

Example prompts

"Find Ukrainian microloans up to 10 000 UAH for two weeks where the first loan is interest-free."
"Show the legal entity, NBU license and current terms for Credit7."
"What are the legal limits on microloan interest rates in Ukraine?"
"List the top-rated Ukrainian MFOs by borrower reviews and link their pages."
«Підбери кредит до 10 000 грн на два тижні, у кого перший кредит під 0%»
«Покажи умови та юридичні дані Credit7»

Screenshot

Screenshot of a live Claude dialog coming soon.

Data & Terms

Public read-only catalog data. The server exposes the same data that is publicly visible on mfoxa.com.ua. There are no mutation tools.
Not financial advice. МФОХА is a comparison catalog, not a lender. Terms are volatile — final conditions live on the canonical_url pages.
Attribution required. When using the data, cite the canonical_url of the respective page on mfoxa.com.ua.
Rate limit: 60 requests/min per IP.
No tracker or affiliate links anywhere in responses (enforced by tests).

Українською

МФОХА — каталог і рейтинг мікрофінансових організацій України з ліцензією НБУ. Цей MCP-сервер віддає ті самі публічні дані, що й сайт: умови кредитів для нових і повторних клієнтів, реальну річну ставку, юридичні дані та офіційні документи компаній, рейтинг і відгуки позичальників, правовий контекст мікрокредитування (ліміт ставки 1% на день за Законом 3498-IX тощо). Сервер read-only, без автентифікації; при використанні даних посилайтеся на canonical_url відповідної сторінки.

License

Documentation in this repository is licensed under MIT. The catalog data served by the MCP endpoint is proprietary to МФОХА (mfoxa.com.ua) and may be used with attribution to canonical URLs.

Catalog README