finwire.pl MCP sunucusu
Commit 13 Kas 2026NBP faiz oranları, TÜFE enflasyonu, konut fiyatları ve makroekonomik göstergeler dahil olmak üzere Polonya'ya ait güncel finans, iş gücü piyasası ve gayrimenkul verileri sağlar.
Ayrıca bilinen adı finwire-pl/api, api
- Yıldızlar
- 2
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.23.0
- Son commit
- 13 Kas 2026
- Lisans
- —
finwire.pl MCP nedir?
finwire.pl bir MCP sunucusudur. NBP faiz oranları, TÜFE enflasyonu, konut fiyatları ve makroekonomik göstergeler dahil olmak üzere Polonya'ya ait güncel finans, iş gücü piyasası ve gayrimenkul verileri sağlar.
Özet, projenin README dosyasından oluşturuldu
finwire.pl MCP sunucusu hakkında
Bu server, geliştiricilerin ve analistlerin Polonya için gerçek zamanlı ekonomik göstergelere erişmesini sağlar. NBP politika faizleri, TÜFE enflasyonu, döviz kurları ve 10 yıllık devlet tahvili getirileri dahil olmak üzere geniş bir veri yelpazesi sunar. Kullanıcılar ayrıca noter senetlerinden alınan daire işlem fiyatları, kira getirileri ve 17 şehirdeki konut arzı gibi spesifik gayrimenkul metriklerini de çekebilir.
Bu araç, kullanımı için API anahtarı veya kayıt gerektirmeyen, ücretsiz ve açık bir REST API olarak çalışır. Verileri HTTPS üzerinden JSON formatında sunar ve AI istemcileriyle kolay entegrasyon için tasarlanmıştır. Şeffaflığı sağlamak amacıyla her yanıt, birincil kaynağını ve doğrudan kopyalanıp yapıştırılabilecek bir atıf bilgisini içerir. Server; mesleklere göre ücretler ve illere göre işsizlik oranları gibi iş gücü piyasası istatistiklerinin yanı sıra elektrikli araçlar, araç sigortası ve emeklilik tahminleri gibi özel veri setlerini de kapsayan çeşitli sektörlere hitap eder.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
finwire.pl MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklefinwire.pl MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http api https://public-api.finwire.pl/mcpfinwire.pl MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}finwire.pl MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://public-api.finwire.pl/mcp"
}
}
}finwire.pl MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"api","type":"http","url":"https://public-api.finwire.pl/mcp"}'finwire.pl MCP'yi Codex içine yükleyin
$ codex mcp add api --url https://public-api.finwire.pl/mcpfinwire.pl MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.api] url = "https://public-api.finwire.pl/mcp"
finwire.pl MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http api https://public-api.finwire.pl/mcpfinwire.pl MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp",
"type": "http"
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirfinwire-pl/api is public and reachablegithub.com/finwire-pl/api ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/finwire-pl/api ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 425 msGeçti
finwire 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 soruları
finwire.pl MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http api https://public-api.finwire.pl/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
finwire.pl MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Bu API bir API anahtarı gerektiriyor mu?
Hayır, API ücretsizdir ve herhangi bir API anahtarı veya kayıt gerektirmez.
WIBOR veya POLSTR verileri mevcut mu?
Hayır, WIBOR ve POLSTR, özel bir Piyasa Veri Lisans Sözleşmesi gerektiren GPW Benchmark verileri olduğu için mevcut değildir.
Ne tür gayrimenkul verilerine erişebilirim?
Noter senetlerinden alınan daire işlem fiyatlarına, istenen kira bedellerine, kira getirilerine ve konut arzı verilerine erişebilirsiniz.