The finwire MCP server gives your assistant live data from Polish public institutions, tax and social security calculations and the rules of Polish law with their legal basis. The assistant picks the tool for each question, and every answer carries the period, the source and a link to finwire.pl.
MCP (Model Context Protocol) is an open standard that lets an assistant connect to external data sources and tools. You add the server address in the assistant settings.
https://public-api.finwire.pl/mcpPick your assistant and add the server address. It takes about a minute, no API key.
In claude.ai or Claude Desktop open Settings, go to Connectors and add a custom connector. Use the finwire server address, no authentication.
https://public-api.finwire.pl/mcp53 tools in 6 areas. Every answer gives the source and a link to the finwire.pl page with the full data.
| Question to the assistant | The answer includes | Live data | Calculation | History | Legal basis |
|---|---|---|---|---|---|
| Economy | |||||
| How is the Polish economy doing? | GDP, inflation, unemployment, wages and rates with the latest reading, change and release date | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| How has inflation moved against wages? | up to four series side by side, month by month | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| What will inflation and the next rate decision be? | calendar of official releases and Monetary Policy Council meetings, Finwire Nowcast forecast with interval and accuracy | Live data: yes | Calculation: yes | History: yes | Legal basis: no |
| Everyday money | |||||
| What does the euro cost and what are the central bank rates? | NBP exchange rates and gold, interest rates with history | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| What do fuel, electricity and groceries cost? | fuel price caps, electricity and gas tariffs, prices of 30 goods in shops | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| Where should savings go? | deposit and savings account rates, retail bonds after tax, IKE, IKZE, PPK, funds and brokerage fees | Live data: yes | Calculation: yes | History: yes | Legal basis: no |
| Will my mortgage payment rise? | chance of a higher payment within a year, payment range, the credit market | Live data: yes | Calculation: yes | History: yes | Legal basis: no |
| How big are pensions and public debt? | average social security benefits, debt per person, household fixed costs, heating subsidies | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| Housing | |||||
| What does a square metre cost in my district? | prices from notarial deeds in cities and districts | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| Buy or rent? | rents, rental yield, running costs of a flat, housing supply and rent forecast | Live data: yes | Calculation: yes | History: yes | Legal basis: no |
| Law and taxes | |||||
| What are next year's IKE limit and minimum wage? | statutory limits and thresholds, next-year estimate from the formulas in law | Live data: yes | Calculation: yes | History: no | Legal basis: yes |
| What is changing in the law? | acts entering into force, bills in parliament, tax rulings | Live data: yes | Calculation: no | History: no | Legal basis: yes |
| Is this firm safe? | the financial regulator's warning list, the deposit guarantee list | Live data: yes | Calculation: no | History: no | Legal basis: yes |
| Business in Poland | |||||
| I'm from abroad. What business can I set up in Poland? | every legal form with yes or no, the reason and the article of law, setup steps and residence requirements | Live data: no | Calculation: yes | History: no | Legal basis: yes |
| What is the take-home pay on employment, mandate, work contract or B2B? | net, social security, health contribution and tax per month and per year | Live data: no | Calculation: yes | History: no | Legal basis: no |
| Sole proprietorship or limited company? | yearly taxes, social security and net income to the owner for each form | Live data: no | Calculation: yes | History: no | Legal basis: no |
| What does hiring an employee cost? | full cost to the employer with each contribution and the employee's take-home pay | Live data: no | Calculation: yes | History: no | Legal basis: no |
| What tax applies to profit paid abroad? | the statutory rate and the tax-treaty rate for the owner's country, EU parent-company exemption | Live data: no | Calculation: yes | History: no | Legal basis: yes |
| What are this year's tax and social security deadlines? | a full deadline calendar for the chosen form, moved to the next working day | Live data: no | Calculation: yes | History: no | Legal basis: yes |
| How do I hire a foreigner? How do I close a business? | rules with legal basis and verification date, Polish-English glossary | Live data: no | Calculation: no | History: no | Legal basis: yes |
| Regions and Europe | |||||
| How does my municipality compare? | income and income tax per resident, local taxes, unemployment, wages, new businesses | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| How does Poland compare with the EU? | house prices, mortgage rates, bond yields, electricity and gas, minimum wage | Live data: yes | Calculation: no | History: yes | Legal basis: no |
| What else can I look for? | catalogue of all finwire datasets and indices with licence and citation | Live data: yes | Calculation: no | History: yes | Legal basis: no |
Examples to copy. The assistant picks the tools by itself.
How is the Polish economy doing? A short briefing with release dates, please.
get_macro_snapshotI am a US citizen on a visa. Which company can I set up in Poland and what is left for me at 400,000 PLN revenue?
plan_business_entryWhat tax does Poland withhold on dividends paid to a German shareholder?
get_tax_treatyWhat does a flat cost per square metre in Krakow according to notarial deeds?
get_housing_pricesWhat will Polish inflation and the next central bank decision be?
get_nowcastWhat does it cost an employer to hire someone at 10,000 PLN gross in Poland?
calc_employer_costAll tools by area, named as the assistant sees them.
get_macro_snapshotheadline indicators, recent changes and next releaseslist_macro_indicatorsfind macro indicator keysget_macro_indicatorone indicator with historycompare_macro_indicators2-4 series side by sideget_macro_changeswhat updated recentlyget_macro_calendarupcoming releases and RPP meetingsget_interest_ratesNBP policy rates and their historyget_currency_ratesNBP exchange rates, currency history, gold priceget_fuel_pricesmaximum fuel prices (Monitor Polski)get_subsidy_statsCzyste Powietrze heating subsidy programme: applications, contracts, payouts, payout queue, heat sources (finwire_clean_air_payout_rate)get_retail_bond_premiumPolish retail savings bonds vs best bank deposits and savings accounts after tax, per series, with retail bond sales (finwire_retail_bond_premium)get_fixed_cost_burdenshare of household net income taken by mortgage, admin fee, utilities and TV licence, Poland and 16 provinces (finwire_fixed_cost_burden)get_ppk_statsPPK (Employee Capital Plans): net assets, active accounts, participants, participation rate, average fee, average account (finwire_ppk_avg_account)get_pension_statsaverage ZUS pension gross and net, other pensions, allowances, pension to wage ratio (finwire_pension_wage_ratio)get_business_registrationsnew, closed and suspended sole proprietorships in CEIDG (MRiT), registrations per 100 closures (finwire_new_business_ratio)get_investment_fundsinvestment funds in Poland (IZFiA): assets, inflows, outflows and net flows by fund group, PPK, finwire_fund_flows_indexget_ike_ikze_statsIKE and IKZE retirement accounts (KNF, half-yearly): accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balanceget_public_debtPolish State Treasury debt, debt per resident (finwire_public_debt_per_capita), public debt % of GDP, state budget deficit (Ministry of Finance)get_energy_pricesregulated household electricity and gas tariffs (URE)get_retail_pricesaverage shop prices of 30 goods and services (GUS), finwire shopping basket, minutes of workget_nowcastFinwire Nowcast (finwire_nowcast): CPI and core inflation forecasts, RPP decision probabilities, accuracyget_lead_forecastscore inflation in 6-12 months (finwire_cost_pressure) and impaired housing and consumer loans in 2-4 quarters (finwire_npl_forecast), 80% intervals, backtest accuracyget_housing_pricesflat prices per m2 from notarial deeds, cities and districts; location premium by district (finwire_location_premium)get_rentsasking rents and rental yieldget_housing_carryhousing carry per city: net rental yield minus mortgage rate, monthly (finwire_housing_carry)get_housing_balancenew residents per new dwelling (finwire_housing_pressure), completions forecast from building permits (finwire_housing_pipeline), 6-month rent forecast (finwire_rent_forecast)get_housing_costsrunning costs of a flat in 20 citieslist_finwire_indicesregistry of finwire indices (finwire_* ids) with latest readingsget_finwire_indexone finwire index by finwire_* id or alias, with history and citationget_rate_riskmortgage payment risk: chance the variable-rate payment rises by >5% in 12 months, payment percentiles in 3/6/12 months, backtest (finwire_rate_risk_gauge); fixed-rate premium (finwire_fixed_rate_premium)get_credit_marketcredit market index (finwire_credit_market_index), NBP lending survey, household loans, BIK housing loan demandget_bank_ratesmarket aggregates of mortgages, cash loans, deposits, savings; retail bondsget_broker_feesbrokerage account fees from official fee tablesget_legal_limitsIKE/IKZE, PIT, minimum wage and other statutory values; local tax limitsget_next_year_limitsnext-year pension indexation, minimum wage, IKE/IKZE limits, ZUS bases and caps from the formulas in law before the act, with interval, stage and backtest (finwire_next_year_limits)get_legal_changesacts entering into force, bills in the Sejm, legal calendar (finwire_legal_calendar)check_knf_warningslook up a firm or website on the KNF public warnings list (finwire_knf_warnings_monitor)check_bfg_guaranteecheck whether a bank or credit union is covered by the BFG deposit guarantee; list counts with history (finwire_bfg_guarantee_monitor)get_tax_rulingstax rulings of KIS and municipalities from EUREKA by personal finance topic: weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulingsplan_business_entrybusiness in Poland: one call for a foreign founder - forms available with reasons, taxes and net per form with treaty dividend rate, setup steps, residence, deadlinesget_business_formsbusiness in Poland: every legal form with available yes/no for the owner status, reason and legal basiscalc_net_incomebusiness in Poland: monthly take-home pay from an employment, mandate or work contract or B2B self-employment (tax scale, flat tax, ryczalt) with ZUS, health and PITcompare_business_formsbusiness in Poland: sole proprietorship (JDG) vs limited company (sp. z o.o.), yearly taxes and net to the owner, treaty dividend ratecalc_employer_costbusiness in Poland: total cost to the employer of a gross salary (ZUS, FP, FGSP, PPK)calc_zus_contributionsbusiness in Poland: ZUS of a sole proprietor under start relief, preferential and full schemeget_tax_treatybusiness in Poland: withholding tax on dividends, interest, royalties paid abroad - statutory vs treaty rate, MLI, parent-subsidiary exemptionget_compliance_calendarbusiness in Poland: yearly tax, ZUS, VAT and reporting deadlines computed from statutory rulesget_business_guidebusiness in Poland: verified facts with act, article and link - VAT for foreign sellers, residence, PESEL, hiring foreigners, labour law, accounting, reliefs, closingget_business_glossarybusiness in Poland: Polish-English glossary of business, tax and ZUS termsget_regional_dataincome and PIT per resident by municipality, property tax reliance of municipalities (finwire_local_tax_squeeze), unemployment and wages by provinceget_europe_dataPoland vs EU: house prices, mortgage rates, bond yields, household electricity and gas prices (finwire_eu_power_price_gap), minimum wagessearch_datasetscatalog of all datasets with the tool to callget_datasetany dataset by id, same data as /v1The same data and calculations are in the free REST API with OpenAPI documentation (page in Polish).
finwire open API