finwire.pl MCP server
Commit 13 Nov 2026finwire-pl/api · typescript
Menyediakan data keuangan, pasar tenaga kerja, dan real estate Polandia secara live termasuk suku bunga NBP, inflasi CPI, harga hunian, dan indikator makroekonomi.
Juga dikenal sebagai finwire-pl/api, api
- Stars
- 2
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.23.0
- Commit terakhir
- 13 Nov 2026
- Lisensi
- —
Apa itu finwire.pl MCP?
finwire.pl adalah MCP server. Menyediakan data keuangan, pasar tenaga kerja, dan real estate Polandia secara live termasuk suku bunga NBP, inflasi CPI, harga hunian, dan indikator makroekonomi.
Ringkasan dibuat dari README proyek
Tentang finwire.pl MCP server
Server ini memungkinkan developer dan analis untuk mengakses indikator ekonomi Polandia secara real-time. Tersedia berbagai macam data mulai dari suku bunga kebijakan NBP, inflasi CPI, nilai tukar, hingga yield obligasi pemerintah tenor 10 tahun. Pengguna juga dapat mengambil metrik real estate spesifik seperti harga transaksi apartemen dari akta notaris, rental yield, dan suplai perumahan di 17 kota.
Tool ini berfungsi sebagai REST API terbuka yang gratis dan tidak memerlukan API key atau registrasi untuk digunakan. Data dikirimkan dalam format JSON melalui HTTPS dan dirancang agar mudah diintegrasikan dengan AI client. Setiap respons menyertakan sumber utamanya serta sitasi yang siap disalin untuk memastikan transparansi. Server ini mencakup berbagai sektor termasuk statistik pasar tenaga kerja seperti upah berdasarkan pekerjaan dan tingkat pengangguran per provinsi, serta dataset khusus untuk kendaraan listrik, asuransi mobil, dan prakiraan pensiun.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal finwire.pl MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal finwire.pl MCP di Claude Code
$ claude mcp add --transport http api https://public-api.finwire.pl/mcpInstal finwire.pl MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}Instal finwire.pl MCP di VS Code
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://public-api.finwire.pl/mcp"
}
}
}Instal finwire.pl MCP di VS Code CLI
$ code --add-mcp '{"name":"api","type":"http","url":"https://public-api.finwire.pl/mcp"}'Instal finwire.pl MCP di Codex
$ codex mcp add api --url https://public-api.finwire.pl/mcpInstal finwire.pl MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.api] url = "https://public-api.finwire.pl/mcp"
Instal finwire.pl MCP di Gemini CLI
$ gemini mcp add -s user --transport http api https://public-api.finwire.pl/mcpInstal finwire.pl MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp",
"type": "http"
}
}
}Tidak perlu environment variable atau API key.Panduan setup:Claude CodeCursorVS CodeClaude Desktop
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →58/100
Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
Tampilkan skor ini di README Anda
- Source repository terhubung dan dapat dijangkaufinwire-pl/api is public and reachablegithub.com/finwire-pl/api ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/finwire-pl/api ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 425 msLolos
README
Lihat di 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 |
Pertanyaan tentang finwire.pl MCP
Bagaimana cara menambahkan finwire.pl MCP ke Claude Code?
Jalankan claude mcp add --transport http api https://public-api.finwire.pl/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan finwire.pl MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah API ini memerlukan API key?
Tidak, API ini gratis dan tidak memerlukan API key atau pendaftaran.
Apakah data WIBOR atau POLSTR tersedia?
Tidak, WIBOR dan POLSTR tidak tersedia karena merupakan data benchmark GPW yang memerlukan Market Data License Agreement khusus.
Jenis data real estate apa yang bisa saya akses?
Anda dapat mengakses harga transaksi apartemen dari akta notaris, harga sewa, rental yield, dan data suplai perumahan.