finwire.pl MCP server
Commit Nov 13, 2026finwire-pl/api · typescript
Provides live Polish financial, labor market, and real estate data including NBP rates, CPI inflation, housing prices, and macroeconomic indicators.
Also known as finwire-pl/api, api
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.23.0
- Last commit
- Nov 13, 2026
- License
- —
What is finwire.pl MCP?
finwire.pl provides live Polish financial, labor market, and real estate data including NBP rates, CPI inflation, housing prices, and macroeconomic indicators.
Summary generated from the project's README
About finwire.pl MCP server
Accessing real-time economic indicators for Poland is what this server enables for developers and analysts. It provides a wide range of data including NBP policy rates, CPI inflation, exchange rates, and 10-year government bond yields. Users can also retrieve specific real estate metrics such as flat transaction prices from notarial deeds, rental yields, and housing supply across 17 cities.
This tool functions as a free, open REST API that requires no API key or registration to use. It delivers data in JSON format over HTTPS and is designed for easy integration with AI clients. Every response includes its primary source and a ready-to-paste citation to ensure transparency. The server covers diverse sectors including labor market statistics like wages by occupation and unemployment rates by province, as well as specialized datasets for electric vehicles, car insurance, and pension forecasts.
Written from the project's README. Every use case is checked against a quote from it.
How to install finwire.pl MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall finwire.pl MCP in Claude Code
$ claude mcp add --transport http api https://public-api.finwire.pl/mcpInstall finwire.pl MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}Install finwire.pl MCP in VS Code
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://public-api.finwire.pl/mcp"
}
}
}Install finwire.pl MCP in VS Code CLI
$ code --add-mcp '{"name":"api","type":"http","url":"https://public-api.finwire.pl/mcp"}'Install finwire.pl MCP in Codex
$ codex mcp add api --url https://public-api.finwire.pl/mcpInstall finwire.pl MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.api] url = "https://public-api.finwire.pl/mcp"
Install finwire.pl MCP in Gemini CLI
$ gemini mcp add -s user --transport http api https://public-api.finwire.pl/mcpInstall finwire.pl MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp",
"type": "http"
}
}
}No environment variables or API keys required.Setup guides:Claude CodeCursorVS CodeClaude Desktop
Automated checks
Ran Nov 15, 2026Full report →58/100
Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
Show this score in your README
- Source repository linked and reachablefinwire-pl/api is public and reachablegithub.com/finwire-pl/api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/finwire-pl/api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 425 msPass
README
View on GitHubfinwire API - free Polish financial data API (NBP, GUS, RCN)
finwire API is a free, open REST API with financial, labour market and real estate data for Poland: NBP policy rates, CPI inflation, NBP exchange rates, 10-year government bond yields, flat transaction prices from notarial deeds, rents, housing supply, wages by occupation, unemployment by province and county, and an economic calendar. No API key, JSON over HTTPS, OpenAPI 3 specification, every response with its primary source and a ready-to-paste citation. Built and maintained by finwire.pl.
curl "https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=90"
- Base URL:
https://public-api.finwire.pl - Auth: none - no key, no sign-up, GET only, CORS enabled (works from the browser)
- Format: JSON, UTF-8,
{ data, meta }envelope - Specification: openapi.json · interactive reference · llms.txt · dataset pages
- Data license: CC BY 4.0 for finwire indicators and aggregates; public data requires attribution to the original source; the license of each dataset is in its
licensefield - WIBOR and POLSTR: not available. They are GPW Benchmark data; redistribution requires a Market Data License Agreement with GPW (gpwbenchmark.pl)
- Changes: CHANGELOG.md
Po polsku: darmowe API z polskimi danymi finansowymi - stopy NBP, inflacja CPI (GUS), kursy walut NBP, rentowności obligacji, ceny transakcyjne mieszkań z Rejestru Cen Nieruchomości, czynsze i rentowność najmu, podaż mieszkań, wynagrodzenia GUS (także według zawodów), bezrobocie w województwach i powiatach, próg wejścia (ile trzeba zarabiać na kredyt na mieszkanie), limity podatku od nieruchomości, kalendarz odczytów makro. Bez klucza i rejestracji. Opis po polsku: finwire.pl/otwarte-api.
Contents
- Data coverage
- Use cases
- Quick start
- MCP server for AI assistants
- Response format and citation
- Endpoints
- FAQ
- Glossary
- OpenAPI specification and TypeScript types
- Rate limits
- Usage policy and disclaimer
Data coverage
Every dataset comes from its primary source and is served in one format, with that source in
meta.
Each dataset name links to its documentation page with fields, source and citation.
| Data | Endpoint | Primary source | Frequency | History |
|---|---|---|---|---|
| NBP policy rates (reference, lombard, deposit, rediscount, discount) | /v1/series/interest-rate/{id} |
NBP | on MPC decisions | up to 10 years |
| CPI inflation (YoY, MoM) | /v1/series/cpi |
GUS | monthly | since 1982 |
| NBP exchange rates (table A mid, table C bid/ask) | /v1/series/fx/{code} |
NBP | daily (business days) | up to 10 years |
| 10-year government bond yields: PL, DE, euro area, EU + spreads | /v1/series/bond-yields/{geo} |
Eurostat irt_lt_mcby_m | monthly | since 2001 |
| Retail government bonds (OTS, ROR, DOR, TOS, COI, EDO, ROS, ROD) | /v1/bonds |
Ministry of Finance | monthly issues | current issues |
| Flat transaction prices per m² (median, quartiles, primary/secondary) - 17 cities and their districts | /v1/housing/transactions/{city} |
Real Estate Price Register (RCN, GUGiK + city registers) | quarterly, ingested daily | last 12 quarters per city |
| Housing prices per m² in 17 cities | /v1/series/housing/{city} |
GUS | quarterly | latest quarters |
| Housing supply: dwellings per 1000, completions, permits, migration | /v1/housing/supply/{city} |
GUS BDL, Census 2021 | yearly | since 2010 |
| Asking rents per city and district | /v1/rent/{city} |
znajdznajem.pl | daily snapshot | current + previous month |
| Rental yield (gross, net, payback) | /v1/rent/yield |
finwire.pl (rents + RCN prices) | daily | current |
| Wages: median, percentiles, 16 provinces | /v1/wages |
GUS | on GUS release | current |
| Wages by occupation: mean, median, deciles, gender gap - about 175 groups | /v1/wages/occupations/{code} |
GUS | every 2 years | survey editions |
| Registered unemployment: Poland, 16 provinces, highest/lowest counties | /v1/series/unemployment |
GUS BDL | monthly | since 2011 |
| Macroeconomic indicators: GDP, retail sales, output, CPI, unemployment, wages, FX, credit, limits | /v1/macro/indicators |
GUS, NBP, Eurostat, Ministry of Finance | on release | full history per indicator |
| Consumer sentiment: BWUK, WWUK and 13 components | /v1/macro/consumer-sentiment |
GUS | monthly | since 2010 |
| Average wage, enterprise sector by province | /v1/wages/enterprise |
GUS | monthly | 2 years |
| Gold price (1 g, fineness 1000) | /v1/series/gold |
NBP | daily (business days) | since 2013 |
| Maximum fuel prices: Pb95, Pb98, diesel | /v1/fuel-prices |
Minister of Energy (Monitor Polski) | on announcement | all announcements |
| Retail prices in shops: 30 goods and services, finwire shopping basket, minutes of work | /v1/prices/retail |
GUS (Dziedzinowa Baza Wiedzy) | monthly | from 2018 |
Business registrations: new, closed, suspended and resumed sole proprietorships in CEIDG, share of women, finwire_new_business_ratio |
/v1/business-registrations |
MRiT (dane.gov.pl) | monthly | from November 2019 |
Vehicle registrations: first registrations by vehicle type and province, passenger-car brands, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share |
/v1/vehicle-registrations |
Ministry of Digital Affairs (CEPiK data, dane.gov.pl) | monthly | from January 2014, brands from January 2023 |
Electric cars: BEV and PHEV fleet and new cars, fuel mix of new cars, counties and provinces, charging vs EV correlation, finwire_ev_share_new_cars |
/v1/electric-vehicles |
Eurostat, GUS BDL, UDT EIPA | yearly | Eurostat from 2013 |
EV charging points: locations, stations and points, fast sites by province and county, finwire_ev_charging_coverage |
/v1/ev-charging |
UDT EIPA | monthly (month ends), daily current state | from December 2019 |
IKE and IKZE retirement accounts: accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balance |
/v1/ike-ikze |
KNF | half-yearly | from June 2020 |
Car insurance: average OC and autocasco premium: average premium per policy over 4 quarters and in the quarter, policies in force, claims paid per 100 PLN of premium, 18 non-life classes, finwire_oc_avg_premium |
/v1/car-insurance |
KNF | quarterly | from Q1 2017 |
Investment funds: assets and net flows of the market, fund groups, PPK, bond types, equity regions, finwire_fund_flows_index |
/v1/investment-funds |
IZFiA | monthly | market from February 2020, groups from February 2022 |
Czyste Powietrze subsidy programme: applications, contracts, payouts, payout queue, heat sources, finwire_clean_air_payout_rate |
/v1/subsidies/clean-air |
NFOŚiGW | weekly | from February 2024 (archived readings) |
Average ZUS pension: gross and net, other pensions, allowances, finwire_pension_wage_ratio |
/v1/pensions |
ZUS, GUS | monthly (preliminary data) | from December 2023 |
Average Pole (finwire_average_pole): median age, median wage, flat price, average mortgage and model payment, pension, spending, car age, top car brand |
/v1/average-pole |
Eurostat, GUS, BIK, NBP, ZUS, Ministry of Digital Affairs | each trait on its source's release (annual to monthly) | latest readings |
Daily price index (finwire_daily_price_index, experimental): online shelf prices of a fixed basket of food, household and personal care products, base month = 100, categories, m/m, food part vs GUS CPI food |
/v1/daily-price-index |
finwire.pl from Frisco.pl, Rossmann.pl, zakupy.biedronka.pl; GUS CPI weights | ||
Pension forecast (finwire_pension_forecast): first ZUS pension as % of the last wage and in today's money by birth year, sex and retirement age and wage level, P10/P50/P90, effect of demography and longer life, OECD and EC benchmarks |
/v1/pension-forecast |
ZUS, Eurostat, GUS, Ministry of Finance | recomputed when ZUS indexation, Eurostat or GUS inputs change | birth years 1966-2006, retirement years to 2075 |
PPK (Employee Capital Plans): net assets, active accounts, participants, participation rate, average fee, finwire_ppk_avg_account |
/v1/ppk |
PFR Portal PPK (monthly bulletin) | monthly | from October 2021 |
Retail savings bonds vs bank deposits: first-year bond rates minus best deposits, savings accounts and average new deposit after tax, finwire_retail_bond_premium |
/v1/retail-bond-premium |
Ministry of Finance, NBP, finwire.pl deposit indices | monthly | from the first month with both bond issue and deposit data |
Household fixed cost burden: mortgage, admin fee, utilities and TV licence as % of net income, Poland and 16 provinces, finwire_fixed_cost_burden |
/v1/fixed-cost-burden |
GUS, NBP, KRRiT | monthly | last 36 months with complete inputs |
Heating season: degree days since 1 July vs the 20-season norm, cold index, season cost of a 100 m2 house, Poland and 17 cities, finwire_heating_season_index, finwire_heating_season_cost |
/v1/heating-season |
IMGW-PIB, Eurostat, URE, GUS | daily | seasons since 1966/67 |
Polish public debt and state budget: State Treasury debt, debt per resident finwire_public_debt_per_capita, public debt % of GDP, budget deficit |
/v1/public-debt |
Ministry of Finance, GUS, Eurostat | monthly (debt), quarterly (% of GDP), monthly (budget estimate) | debt from January 2001, budget from 2018 |
PIT returns by municipality: PIT due per resident finwire_pit_per_capita, by type of return (PIT-37, PIT-36L, PIT-28, PIT-38), every municipality and province |
/v1/pit/summary, /v1/pit/municipalities, /v1/pit/municipalities/{teryt} |
Ministry of Finance, GUS | yearly | tax years from 2022 |
| Regulated electricity and gas prices: household tariffs G11, G12, G12w and W-1.1 to W-4 | /v1/energy/regulated-prices |
President of URE (tariff decisions) | on new decision | tariff years in force |
| Brokerage account fees: commissions on GPW, US and German stocks, account and FX fees | /v1/brokers |
brokers' official fee tables, compiled by finwire.pl | weekly check | current fee tables |
| Legal changes radar: acts entering into force, bills in the Sejm | /v1/legal-changes |
Sejm ELI API | daily | upcoming and recent |
| Residents income by municipality and county | /v1/income/municipalities |
Ministry of Finance (Rb-27S), GUS BDL, computed by finwire.pl | yearly, quarterly update | budget years |
Coal price and waste fee by province (finwire_coal_price_pl, finwire_waste_fee_pl) |
/v1/coal-waste-prices |
GUS BDL | yearly | 2020 onwards |
| Housing running costs in 20 cities | /v1/housing/upkeep/{city} |
GUS BDL | yearly | latest year |
| House prices and housing conditions in Europe | /v1/housing/europe |
Eurostat | quarterly, yearly | since 2010 (conditions) |
| Bank lending survey | /v1/credit-market/survey |
NBP | quarterly | editions |
| Household loans and deposits | /v1/credit-market/monetary |
NBP | monthly | up to 400 months |
| Housing loan demand (BIK) | /v1/credit-market/demand |
BIK, NBP | monthly | from 2025-08 |
Mortgage payment risk and fixed-rate premium: chance the variable-rate payment rises by more than 5% in 12 months, payment percentiles in 3, 6 and 12 months, backtest accuracy, finwire_rate_risk_gauge, finwire_fixed_rate_premium |
/v1/credit-market/rate-risk |
finwire.pl model on GPW Benchmark WIBOR (result only), bank offers, ECB MIR | daily | month ends from 2008 |
| Interest rates on new loans in Europe | /v1/credit-market/ecb-rates |
ECB MIR | monthly | since 2014 |
Electricity and gas prices for households in the EU: EUR, PPS, PLN, finwire_eu_power_price_gap, kWh per minimum wage |
/v1/europe/energy-prices |
Eurostat (nrg_pc_204, nrg_pc_202) | half-yearly | since 2007 |
Fuel prices in EU countries: petrol 95, diesel, LPG, heating oil in EUR and PLN per litre, taxes, rank, finwire_eu_fuel_price_gap |
/v1/europe/fuel-prices |
European Commission (Weekly Oil Bulletin), NBP | weekly | since 2005 |
GDP per capita in the EU: PPS (EU27 = 100) and EUR per inhabitant, real growth, AIC consumption, price level, latest quarter GDP growth, finwire_eu_convergence_years |
/v1/europe/gdp-per-capita |
Eurostat (nama_10_pc, prc_ppp_ind_1, namq_10_gdp) | yearly and quarterly | since 1995 |
| Minimum wages in the EU: EUR, PPS, national currency | /v1/europe/minimum-wages |
Eurostat (earn_mw_cur) | half-yearly | since 1999 |
Inflation (HICP) in EU countries: ranking, Poland, core, food, energy, services, basket since a year, finwire_eu_inflation_gap |
/v1/europe/inflation |
Eurostat | ||
Unemployment in EU countries: total and under 25, rank, Poland rank over time, finwire_eu_youth_unemployment_ratio |
/v1/europe/unemployment |
Eurostat (une_rt_m) | monthly | since 2010 |
Net earnings in the EU by household type: EUR, PPS, gross, tax, contributions, labour cost per hour, tax wedge, finwire_eu_net_wage_gap, own salary vs every EU country |
/v1/europe/net-earnings |
Eurostat (earn_nt_net, lc_lci_lev, earn_nt_taxwedge) | yearly | since 2010 |
Government debt and deficit in the EU: % of GDP, ranks, 3% and 60% reference values, finwire_eu_debt_threshold_gap |
/v1/europe/public-debt |
Eurostat (gov_10dd_edpt1, gov_10q_ggdebt) | yearly, quarterly | since 2000 (yearly), 2010 (quarterly) |
Living conditions in the EU (EU-SILC): own home with and without a mortgage, renting, people who cannot face an unexpected expense, median and mean household income per person in EUR and PPS, finwire_eu_mortgaged_owners, finwire_eu_household_income_gap |
/v1/europe/living-conditions |
Eurostat (ilc_lvho02, ilc_mdes04, ilc_di03) | yearly | since 2005 |
| Economic calendar: MPC (RPP) decisions, CPI, wages, GDP, unemployment | /v1/calendar |
GUS, NBP, compiled by finwire.pl | continuous | upcoming events |
| IKE / IKZE contribution limits | /v1/legal-limits |
Ministry of Family announcements | yearly | current year |
| Property tax upper limits | /v1/legal-limits/local-tax |
Minister of Finance (Monitor Polski) | yearly | announced tax years |
| Deposit, savings, mortgage and cash loan rate aggregates | /v1/market/* |
finwire.pl (aggregate of offers on the market) | daily | current |
finwire index registry: every index computed by finwire.pl under a stable finwire_* id (list) |
/v1/finwire-index/{id} |
finwire.pl (method and sources per index) | daily, monthly or quarterly per index | per index |
Legal calendar (finwire_legal_calendar): PIT, ZUS and VAT deadlines, IKE/IKZE year end, changes of statutory values, acts entering into force, RPP meetings, retail bond sales |
/v1/legal-calendar |
Sejm ELI API, NBP, Ministry of Finance, statutory deadlines, compiled by finwire.pl | daily | upcoming events, ICS at finwire.pl/kalendarz-zmian.ics |
KNF public warnings: entries verbatim from KNF, counts by legal basis, entity lookup, weekly new entries (finwire_knf_warnings_monitor) |
/v1/knf-warnings |
KNF, lista ostrzeżeń publicznych | 3 times a day | current list, weekly series since November 2026 |
BFG deposit guarantee list: banks and credit unions covered by the BFG guarantee, counts by group with history (finwire_bfg_guarantee_monitor), latest changes, lookup by name or website |
/v1/bfg-guarantee |
BFG, lista podmiotów objętych gwarancjami | twice a day | every change of the list since 2019 |
Court rulings in credit disputes: rulings of common courts on CHF and other currency mortgages, WIBOR, free credit sanction, early repayment refunds and unit-linked policies, monthly counts, share for the borrower (finwire_borrower_win_share), instances, newest rulings with links |
/v1/credit-judgments |
Court Rulings Portal, Ministry of Justice via SAOS | daily | all published rulings, history filled over the first weeks |
Tax rulings: KIS and municipal individual rulings by personal finance topic, weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulings with links |
/v1/tax-rulings |
Ministry of Finance, EUREKA | daily | last 53 weeks, growing |
| [Next-year statutory limits](https://public-api.fin |
finwire.pl MCP questions
How do I add finwire.pl MCP to Claude Code?
Run claude mcp add --transport http api https://public-api.finwire.pl/mcp in your terminal. Add --scope user to make it available in every project.
How do I add finwire.pl MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this API require an API key?
No, the API is free and does not require an API key or sign-up.
Is WIBOR or POLSTR data available?
No, WIBOR and POLSTR are not available as they are GPW Benchmark data requiring a specific Market Data License Agreement.
What kind of real estate data can I access?
You can access flat transaction prices from notarial deeds, asking rents, rental yields, and housing supply data.