Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.
Connect Remote server
claude mcp add --transport http data https://public-api.finwire.pl/mcp{
"mcpServers": {
"data": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}{
"servers": {
"data": {
"type": "http",
"url": "https://public-api.finwire.pl/mcp"
}
}
}Settings > Connectors > Add custom connector
URL: https://public-api.finwire.pl/mcpTools 78 found in our last check
get_macro_snapshotUse for a general view of the Polish economy or a briefing. For one indicator, use get_macro_indicator. Returns the six headline indicators (GDP, inflation, unemployment, wages, rates and similar) with latest reading, change and freshness, which indicators changed recently, and…
list_macro_indicatorsUse first to find the key of a macro indicator. Then use get_macro_indicator with that key. Find indicators and their keys. Latest reading, change, next release and source for GDP, CPI and core inflation, unemployment, wages, retail sales, industrial output, NBP rates, FX, consu…
get_macro_indicatorUse for the value, the meaning or the trend of one macro indicator. One indicator by key with its meaning, latest reading, freshness, next release and history (oldest first) with min and max over the window.
compare_macro_indicatorsUse for 2-4 macro series side by side, for example inflation and wages. History of 2-4 indicators aligned by period. All keys must have the same frequency (all monthly, or all quarterly); otherwise the call fails and says which differ.
get_macro_changesUse when the user asks what is new in macro data. Indicators whose reading was updated in the last N days (newest first), with the change against the previous reading.
get_macro_calendarUse for the dates of the next macro releases and RPP meetings. For tax deadlines, use get_legal_changes or get_compliance_calendar. Upcoming Polish macro releases and decisions (RPP rate decisions, CPI, wages, GDP, industrial output) with date, time and importance (higher is mor…
search_datasetsUse when no other tool is applicable. Then use get_dataset with the id from the result. Catalog of all finwire.pl datasets (rates, FX, gold, fuel and energy prices, Finwire Nowcast, broker fees, housing prices and rents, credit market, legal limits and law changes, regional inco…
get_datasetUse after search_datasets, and only when no dedicated tool is applicable. Any dataset by id from search_datasets, with optional params listed there. Returns the same data as the public REST API /v1 (long lists shortened).
get_interest_ratesUse for NBP policy rates. For bank offers, use get_bank_rates. Current NBP policy rates (reference, lombard, deposit, rediscount, discount) with the date of the last change, or the history of one rate. WIBOR and POLSTR are not available (GPW Benchmark license).
get_currency_ratesUse for exchange rates and the gold price. NBP mid, bid and ask rates of currencies against PLN (table), the history of one currency, or the NBP gold price (code "XAU").
get_fuel_pricesUse for the maximum fuel prices that the state sets. For average prices in shops, use get_retail_prices. Maximum retail prices of Pb95, Pb98 and diesel in PLN per litre announced by the Minister of Energy in Monitor Polski: price in force, next day price if announced, and recent…
get_retail_pricesUse for prices in shops, for example butter, bread or milk, and for the shopping basket. Average retail prices of 30 goods and services in Poland from GUS (bread, butter, milk, eggs, meat, vegetables, sugar, electricity, gas, heating, petrol, diesel, bus ticket, taxi, haircut, d…
get_pension_statsUse for the average ZUS pension paid now, disability and survivor pensions, and sickness allowances. For a future pension, use get_pension_forecast. Average old-age pension paid by ZUS (gross and net), disability and survivor pensions, number of pensioners, sickness and maternit…
get_average_poleUse for the typical or average person in Poland: median age, wage, flat, mortgage, pension, spending and car. Profile of the typical person in Poland (finwire_average_pole) built from the latest official readings: median age (Eurostat), median gross and net wage (GUS), median pr…
get_daily_price_indexUse for daily online prices of a basket of food, household and personal care products. For official CPI, use get_macro_indicator. Experimental daily index of online shelf prices of a fixed basket of food, drinks, household and personal care products in three Polish online shops…
get_pension_forecastUse for the future ZUS pension of a person and the replacement rate by birth year, sex and wage. For pensions paid now, use get_pension_stats. Model of the first gross ZUS pension in Poland (finwire_pension_forecast) by birth year 1966-2006, profile (k60 = woman retiring at 60,…
get_investment_fundsUse for investment fund assets and net flows: equity, bond, mixed and PPK funds. Assets, purchases of units, redemptions and net flows of investment funds in Poland from monthly IZFiA data: whole market, fund groups (short-term bond, bond, equity, mixed, PPK, target date, absolu…
get_business_registrationsUse for the number of new, closed and suspended sole proprietorships (CEIDG). To start a business, use plan_business_entry or get_business_guide. Monthly applications filed in CEIDG, the Polish register of sole proprietorships (Ministry of Development and Technology data on dane…
get_vehicle_registrationsUse for car registrations, car brands and Chinese car brands. First registrations of vehicles in Poland, monthly since 2014, from the Ministry of Digital Affairs files with CEPiK data: passenger cars and all vehicles, 17 vehicle types, provinces per 1000 residents, top passenger…
get_electric_vehiclesUse for the number of electric cars (BEV, PHEV) by year, county and province. Battery electric (BEV) and plug-in hybrid (PHEV) passenger cars in Poland: fleet at year end and new cars in the year with shares (Eurostat), fuel mix of new cars, provinces and counties per 1000 passe…
get_ev_chargingUse for statistics of EV charging points in Poland, provinces and counties. For chargers near a place, use find_ev_chargers. Public EV charging in Poland from the UDT register EIPA: locations, stations and charging points today and at each month end since December 2019, growth y…
find_ev_chargersUse to find EV chargers near a place: fast, free or available chargers. Public EV charging sites in Poland from the UDT register EIPA near a city or a point: give city, or lat and lon with radius_km. Filters: min_kw (e.g. 150 for ultra-fast), free_charging, available_now (at lea…
get_ev_charging_pricesUse for the EV charging price per kWh and network price lists. Ad hoc EV charging prices in Poland (for a driver without a contract) reported by operators to the UDT register EIPA: median price per kWh with point counts by power class (AC up to 22 kW, DC below 50 kW, DC 50-149 k…
get_ike_ikze_statsUse for the IKE and IKZE market: accounts, assets, contributions by institution type and average balance. IKE and IKZE (Polish individual retirement accounts with tax relief) from half-yearly KNF data: number of accounts and assets, split by institution type (insurers, investmen…
get_car_insurance_marketUse for the average price of car insurance (OC and autocasco) in Poland, its trend and the size of the market. Tell the user that this is a market average and not a quote for one driver. Average car insurance premium in Poland from the quarterly KNF bulletin "Rynek ubezpieczeń"…
get_subsidy_statsUse for Czyste Powietrze heating subsidies: applications, contracts and payments. Czyste Powietrze (Clean Air), the Polish subsidy programme for replacing heating sources and thermal modernisation of single-family houses, from the weekly NFOŚiGW summary: applications, contracts…
get_retail_bond_premiumUse to compare retail savings bonds with bank deposits after tax. Premia obligacji skarbowych finwire (finwire_retail_bond_premium): by how much the first-year rate of Polish State Treasury retail savings bonds (OTS, ROR, DOR, TOS, COI, EDO; family ROS and ROD separately) exceed…
get_fixed_cost_burdenUse for the share of household income that goes to the mortgage, admin fees and utilities, by province. Sztywne koszty gospodarstwa finwire (finwire_fixed_cost_burden): share of net income of a model household (two earners on the regional median wage) taken by the mortgage payme…
get_municipal_budgetUse for the budget of one municipality: what it spends money on, its debt and its EU funds. Pieniądze Twojej gminy (finwire_gmina_spending_per_capita): for one Polish municipality (gmina) or city with county rights - executed spending per resident by category (schools, social he…
get_heating_seasonUse for the heating season: degree days, the cold of this winter against the norm, and the heating bill forecast. Indeks chłodu sezonu finwire (finwire_heating_season_index) and Koszt sezonu grzewczego finwire (finwire_heating_season_cost): heating degree days since 1 July (Euro…
get_ppk_statsUse for PPK workplace pensions: participants, participation rate, net assets, average account and fees. PPK (Pracownicze Plany Kapitałowe), the Polish auto-enrolment workplace pension programme, from the monthly PFR Portal PPK bulletin (PPK Register kept by PFR): net assets of t…
get_public_debtUse for public debt, State Treasury debt, debt per person and the budget deficit. For EU countries, use get_eu_public_debt. State Treasury debt of Poland at the end of the latest month (Ministry of Finance): amount, change, debt per resident finwire_public_debt_per_capita, avera…
list_finwire_indicesUse for a list of all finwire indices (id finwire_*) with the latest values. Give the id and the method version from the citation field. All indices computed by finwire.pl, each under a stable id finwire_* (e.g. finwire_mortgage_barometer, finwire_credit_capacity_index, finwire_…
get_finwire_indexUse for one finwire index with history. Find the id with list_finwire_indices. Give the id and the method version from the citation field. One finwire index by its id finwire_* (old dataset ids such as credit-market-index, borrowing-power or credit-stress are accepted as aliases…
get_nowcastUse for the next CPI or core inflation value and the next RPP decision. Tell the user that this is a model estimate. Give the interval or the probabilities, and the accuracy. Write the source as "Finwire Nowcast (finwire.pl)". Finwire Nowcast (finwire id: finwire_nowcast), the f…
get_lead_forecastsUse for core inflation in 6-12 months and for impaired (Stage 3) housing and consumer loans in 2-4 quarters. Give the 80% interval and the backtest coverage. If published is false, there is no forecast to give. Two finwire.pl models with 80% intervals. finwire_cost_pressure (Pre…
get_energy_pricesUse for regulated electricity and gas tariffs in Poland. For prices in the EU, use get_europe_data. Household electricity and gas tariffs approved by URE and in force today: electricity energy price of the default seller and distribution rates per operator for G11, G12 and G12w…
get_broker_feesUse for brokerage account fees. Fees of brokers available to Polish investors from their official fee tables: online order commission on Warsaw (GPW), US and German stocks and ETFs, account and currency conversion fees, IKE/IKZE, investor protection and promotions valid today, w…
get_housing_pricesUse for flat prices per m2 in a city or district. Transaction prices of flats per square meter from notarial deeds (RCN): median, quartiles, year-over-year change and number of deeds in 17 cities, or per district of one city. source "gus" gives the GUS quarterly series instead.…
get_rentsUse for rents and rental yield. Asking rents (median, per m², month-over-month change) in Polish cities and districts, with gross and net rental yield and payback period.
get_housing_carryUse to find if rent covers mortgage interest in a city (net yield minus mortgage rate). Carry nieruchomości finwire (finwire_housing_carry): per Polish city, the net rental yield of a typical 2-room flat (after one vacant month, flat-rate rental tax, admin fee in vacant months a…
get_housing_balanceUse for housing demand against supply, the completions forecast and the rent forecast. finwire housing balance for Poland and 17 cities: finwire_housing_pressure (new residents per 1 dwelling completed in the same year, from GUS migration for permanent residence and foreigners i…
get_coal_waste_pricesUse for the average price of a tonne of coal or the waste collection fee, in Poland and by province. Cena węgla finwire (finwire_coal_price_pl) and Opłata za odpady finwire (finwire_waste_fee_pl): annual average price of a tonne of hard coal and monthly fee for sorted waste coll…
get_housing_costsUse for the running costs of a flat. Monthly running costs of a flat in 20 largest cities: co-op and owners association charges per m², heating, electricity, gas, water and waste rates, each with year and scope (city or province).
get_credit_marketUse for the state of the mortgage market: lending criteria, demand and new loans. Polish housing loan market: topic "index" (finwire 0-100 credit market index, returns finwire_credit_market_index), "survey" (NBP bank lending survey: criteria and demand), "monetary" (NBP househol…
get_rate_riskUse when the user asks if a mortgage payment will rise. Also use for the payment in a year and the fixed against variable rate premium. finwire model on WIBOR fixings and bank offers: finwire_rate_risk_gauge (Ryzyko raty finwire) - chance that the payment of a PLN 400,000, 30-ye…
get_bank_ratesUse for market rates of mortgages, cash loans, deposits, savings accounts and retail bonds. For NBP rates, use get_interest_rates. Aggregates of offers currently on the market (median and percentiles, no single bank offers): mortgage APRC and margin, cash loan APRC, term deposit…
get_legal_limitsUse for statutory values of this year: IKE and IKZE limits, PIT and minimum wage. For next year, use get_next_year_limits. Statutory values for the current year: IKE and IKZE contribution limits, PIT thresholds and rates, tax-free amount, capital gains tax, rental flat-rate tax,…
get_next_year_limitsUse for next-year pension indexation, minimum wage, IKE and IKZE limits and ZUS bases before the official announcement. Tell the user that this is a formula estimate. Give the interval and the stage. Statutory values for the next year computed by finwire.pl from the formulas in…
get_legal_changesUse for new laws and for the next PIT, ZUS and VAT deadlines. For the full yearly calendar of a business, use get_compliance_calendar. Acts of the Journal of Laws and Monitor Polski on personal finance, tax, labour and housing: entering into force soon and recently, with plain-l…
check_knf_warningsUse to check if the KNF warnings list contains a company, an investment platform or a website. Look up a company, investment platform or website on the public warnings list of the Polish Financial Supervision Authority (KNF) by name, website domain, KRS, NIP or REGON. Returns ma…
check_bfg_guaranteeUse to check if the BFG deposit guarantee includes a bank or a credit union. Check whether a Polish bank or credit union (SKOK) is on the list of entities covered by the deposit guarantee of the Bankowy Fundusz Gwarancyjny (BFG), by name, trade name (e.g. "Inteligo") or website.…
get_tax_rulingsUse for individual tax rulings by topic, for example rental income, crypto or IKE and IKZE. Individual tax rulings of the Polish tax information office (KIS) and municipal rulings on property tax, published in the EUREKA database of the Ministry of Finance, by topic: private ren…
get_credit_judgmentsUse for court rulings in consumer credit disputes (CHF loans, WIBOR, free credit sanction, early repayment) and the share that borrowers won. Statistics of rulings of Polish common courts in consumer credit disputes, published in the Court Rulings Portal of the Ministry of Justi…
get_regional_dataUse for data about municipalities and provinces: income, PIT, local tax, unemployment and wages. For the budget of one municipality, use get_municipal_budget. Regional data: "income" (residents income per capita by municipality, or county with level "powiat"), "pit" (PIT due per…
get_europe_dataUse to compare Poland with the EU: house prices, mortgage rates, bond yields, household electricity and gas prices, and minimum wages. Poland compared with EU countries: "house-prices" (Eurostat house price index), "mortgage-rates" (ECB rates on new housing loans), "bond-yields"…
get_family_benefitsUse for how many children get 800 plus or Aktywny Rodzic (babciowe, nursery, at home) and how much ZUS pays, in Poland, by voivodeship and by municipality (gmina). Give ZUS as the source. Monthly statistics of ZUS (Polish Social Insurance Institution) on the child benefit 800 pl…
get_consumer_bankruptciesUse for the number of people who declare consumer bankruptcy in Poland, by month and year. Give COIG as the source. Number of people declared bankrupt as consumers in Poland per month, compiled by COIG (Centralny Ośrodek Informacji Gospodarczych) from court announcements in the…
get_pit_settlement_statsUse for how many people in Poland settle PIT, how many are in the second tax bracket and what share of tax they pay, how many use child relief, IKZE or other reliefs, overpayments, flat tax and lump-sum tax returns. For PIT by municipality, use get_regional_data. For tax rates a…
get_rkm_price_limitsUse for the maximum price per m2 in the family housing loan without down payment (rodzinny kredyt mieszkaniowy, BGK guarantee) in a city or voivodeship, and to check if a flat qualifies. Give BGK as the source and the quarter. Maximum price per m2 of a flat that can be bought wi…
get_savings_bond_salesUse for how many savings bonds people buy in Poland, which series sell best, the sum since January against earlier years, IKE and IKZE purchases and buyer age. For bond interest rates and bonds against deposits, use get_retail_bond_premium. Retail savings bonds of the State Trea…
get_eu_fuel_pricesUse for fuel prices in other EU countries, Poland against the EU, and where to fill the tank on a trip abroad. Say that the prices are national averages. Prices of Euro-super 95 petrol, diesel, LPG or heating oil at filling stations in the 27 EU countries from the European Commi…
get_eu_inflationUse for inflation in EU countries, the place of Poland in the EU and price growth since a year. For the CPI of Statistics Poland, use get_macro_indicator. Harmonised inflation (HICP, annual rate) in the 27 EU countries, the EU and the euro area from Eurostat, monthly since 2000:…
get_eu_unemploymentUse to compare unemployment in Poland with EU countries, also youth unemployment. For registered unemployment in Polish voivodeships, use get_regional_data. Monthly unemployment rate in the 27 EU countries, the EU and the euro area from Eurostat (une_rt_m, seasonally adjusted, I…
get_eu_earningsUse for salaries and net pay in EU countries, how Polish pay compares with the EU or one country, and how a given net salary in PLN compares with the average in each EU country. For minimum wages, use get_europe_data. Annual net earnings (take-home pay after income tax and emplo…
get_eu_gdpUse for GDP per capita of EU countries, Poland against the EU in purchasing power, GDP growth of EU countries in a quarter, and when Poland could reach the EU average or another country. Tell the user that the catch-up year is arithmetic, not a forecast. GDP per capita of the 27…
get_eu_public_debtUse for government debt and deficit of EU countries and Poland against the EU, and for the 3% and 60% of GDP reference values. For Polish State Treasury debt per month, use get_public_debt. General government gross debt, deficit and interest as % of GDP in the 27 EU countries, t…
get_eu_living_conditionsUse for how many people own their home with or without a mortgage or rent in EU countries, for people who cannot pay an unexpected expense (financial cushion) and for household income per person in EU countries. For house prices in the EU, use get_europe_data. For net pay, use g…
calc_net_incomeUse for take-home pay from an employment, mandate or work contract or B2B self-employment. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Monthly take-home pay in Poland from: employment contract (uop: umo…
calc_employer_costUse for the cost of an employee to the employer. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Total monthly cost to the employer of an employment contract (umowa o pracę) or a mandate contract (umowa zle…
compare_business_formsUse to compare a sole proprietorship (JDG) with a limited company (sp. z o.o.) by taxes and net income to the owner. For a shareholder resident abroad, give the dividend rate from get_tax_treaty. Give the inputs and the assumptions with the result. The result is a calculation fr…
calc_zus_contributionsUse for the social security contributions of a sole proprietor. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Monthly social security contributions (ZUS: pension, disability, sickness, accident, Labour Fu…
plan_business_entryUse when a person from abroad wants to start a business in Poland: available forms, taxes per form, steps and deadlines. Give the legal basis and the verification date of each fact. One call for someone from abroad starting a business in Poland: every legal form with available y…
get_business_formsUse to find which business forms a foreigner or a foreign company can use, and why. Give the legal basis and the verification date of each fact. All Polish business forms (sole proprietorship JDG, unregistered activity, sp. z o.o., P.S.A., S.A., general, limited and professional…
get_tax_treatyUse for tax on dividends, interest or royalties paid abroad. Also use for the countries that invest the most in Poland (NBP data). Give the legal basis and the verification date of each fact. Polish withholding tax on dividends, interest and royalties paid to a resident of a cou…
get_compliance_calendarUse for the yearly tax, ZUS, VAT and reporting deadlines of a business. Calendar of tax, ZUS, VAT, payroll and reporting deadlines for a calendar year: monthly PIT/CIT advances or ryczałt, own ZUS, JPK_V7M, PIT and ZUS of employees, PPK, annual returns, annual health contributio…
get_business_guideUse for company tax regimes and reliefs (CIT, Estonian CIT, IP Box, R&D relief, Polish Investment Zone). Also use for VAT, residence permits, PESEL, e-signature, hiring foreigners, labour law, accounting and closing a business. Give the legal basis and the verification date of e…
get_business_glossaryUse for the meaning of Polish business, tax and ZUS terms. Polish-English glossary of business, tax, ZUS and registration terms (JDG, sp. z o.o., CEIDG, KRS, ryczałt, KPiR, KSeF, JPK, CRBR, UPO, PSI and others) with one-line explanations.
Details
| Endpoint | https://public-api.finwire.pl/mcp (Streamable HTTP) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | pl.finwire/data |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.