nbp-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_rateA | Get the NBP exchange rate for a single currency vs PLN, on a specific date or the latest available. Table A = daily rates for major currencies (USD, EUR, GBP, CHF, JPY, etc.). Table B = twice-weekly rates for less common currencies. Table C = daily buy/sell rates (bid/ask) for major currencies — use for actual FX transactions, not accounting. For invoice-to-PLN conversion in Polish bookkeeping, use Table A. Note: NBP does not publish on weekends/holidays. |
| list_ratesA | List all currency rates from an NBP table on a given date (or latest). Useful for seeing what's available and comparing multiple currencies at once. |
| get_rate_historyA | Get the NBP exchange rate history for a currency over a date range. Range must be at most 367 days per NBP API limits. |
| get_goldA | Get the NBP gold fixing (cena złota) in PLN per gram of 1000-fineness gold, on a specific date or the latest. Published daily on business days. |
| get_gold_historyA | Get NBP gold fixing history over a date range. Range must be at most 367 days per NBP API limits. |
| convertA | Convert an amount from one currency to another using NBP mid-rate (Table A, or B if not in A). Primary use case: converting a foreign-currency invoice to PLN for Polish bookkeeping. Polish tax law requires using the NBP mid-rate from the last business day BEFORE the invoice date — pass that date as |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a distinct purpose: getting single rates, rate history, gold price, gold history, listing all rates, and conversion. No overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case (get_rate, list_rates, convert, etc.), making them predictable and easy to remember.
With 6 tools, the server is well-scoped for an NBP exchange rate API, covering core operations without being too many or too few.
The tool set covers getting current and historical rates, gold prices, listing all rates, and conversion. Minor gap: no explicit tool for bid/ask rates, but get_rate with Table C can retrieve them.