Unofficial MCP server for the National Bank of Ukraine (NBU) public API
47 tools with consistent naming (verb_noun pattern: get_*) and basic descriptions. However, critical gaps undermine quality: (1) Input schemas visible but parameter descriptions are minimal or generic ('Optional date in format YYYYMMDD' repeated 30+ times); (2) No output schemas documented, LLMs cannot plan downstream calls or extract fields; (3) No error handling guidance, tools return raw API responses without recovery hints; (4) Parameter constraints not formalized (date format stated in text, not regex/pattern); (5) Many tools accept optional parameters with unclear defaults or side effects. Naming is strong (all verb_noun, action-oriented), but descriptions lack LLM-optimization depth (most 50-100 chars, below 194-char baseline for A+ tools). Schema completeness is low, input types present but output types absent.
Make a raw API call to any NBU API endpoint
Get balance of payments data
Get bank financial statements
Get bank income and expenses statistics
Get bank KPI (key performance indicators)
Get bank license details
Get bank managers information
Get registry of banks and their branches
Get bank turnover statistics
No output schemas documented for any tool. LLMs cannot infer response structure, field names, or types. Prevents downstream tool chaining and forces agents to guess at field extraction.
Parameter descriptions are generic and repetitive ('Optional date in format YYYYMMDD' appears 30+ times). No actionable guidance on when to use optional params, what defaults apply, or how they affect results.
No error handling guidance. Tools return raw API responses without recovery hints. If a date is invalid or a resource not found, LLM has no guidance on what to try next.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | 2026-07-28+ | v2 |
Get budget statistics
Get business survey data
Get deposit corporations balance sheet (SR2 survey)
Get deposit corporations survey data
Get deposit corporations survey data including NBU
Get banking system deposit statistics
Get the NBU dollar reference rate
Get economic activity statistics
Get current or historical exchange rates for currencies against UAH
Get exchange rates for a date range
Get foreign direct investment flows
Get foreign direct investment stocks
Get financial corporations survey data
Get foreign bank offices in Ukraine
Get FX market statistics
Get gross external debt statistics
Get inflation statistics
Get NBU interest rates (MIR - monetary policy rates)
Get international investment position data
Get international reserves statistics
Get the NBU key policy rate
Get labor market statistics
Get banking system liquidity statistics
Get banking system loan statistics
Get loans to individuals statistics
Get MFO (bank identification) codes
Get monetary aggregates (M0, M1, M2, M3)
Get NBU balance sheet (SR1 survey)
Get NBU survey data (RE survey)
Get other financial corporations balance sheet (SR4 survey)
Get other financial corporations survey data
Get OVDP (government securities) auction data
Get NBU reference swap rates
Get banking system securities statistics
Get directory of securities
Get short-term external debt statistics
Get UONIA (Ukrainian Overnight Index Average) rates
Look up NBU ID by EDRPOU (Ukrainian business registration number)
Date format constraints stated in text ('YYYYMMDD') but not formalized as regex patterns in schema. LLMs may pass invalid formats (e.g., 'YYYY-MM-DD', '2024/01/15') without validation feedback.
call_api tool is a generic escape hatch that bypasses all structure. Naming is vague ('call_api' vs 'make_nbu_api_request'). Encourages LLMs to avoid specific tools and construct raw API calls, defeating the purpose of a structured toolkit.