MCP server finwire.pl
Коммит 13 нояб. 2026 г.finwire-pl/api · typescript
Предоставляет актуальные данные по финансам, рынку труда и недвижимости Польши, включая ставки NBP, инфляцию CPI, цены на жилье и макроэкономические показатели.
Также известен как finwire-pl/api, api
- Звёзды
- 2
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 1.23.0
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- —
Что такое finwire.pl MCP?
finwire.pl — это MCP server. Предоставляет актуальные данные по финансам, рынку труда и недвижимости Польши, включая ставки NBP, инфляцию CPI, цены на жилье и макроэкономические показатели.
Сводка сгенерирована из README проекта
О finwire.pl MCP server
Этот сервер позволяет разработчикам и аналитикам получать экономические показатели Польши в режиме реального времени. Он предоставляет широкий спектр данных, включая процентные ставки NBP, инфляцию CPI, валютные курсы и доходность 10-летних государственных облигаций. Пользователи также могут извлекать специфические метрики недвижимости, такие как цены на сделки с квартирами по нотариальным актам, доходность от аренды и данные о предложении жилья в 17 городах.
Инструмент работает как бесплатный открытый REST API, который не требует API-ключа или регистрации. Данные передаются в формате JSON через HTTPS и оптимизированы для простой интеграции с AI-клиентами. Каждый ответ содержит ссылку на первоисточник и готовую к копированию цитату для обеспечения прозрачности. Сервер охватывает различные секторы, включая статистику рынка труда (например, уровень зарплат по профессиям и уровень безработицы по воеводствам), а также специализированные наборы данных по электромобилям, страхованию автомобилей и пенсионным прогнозам.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить finwire.pl MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка finwire.pl MCP в Claude Code
$ claude mcp add --transport http api https://public-api.finwire.pl/mcpУстановка finwire.pl MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}Установка finwire.pl MCP в VS Code
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://public-api.finwire.pl/mcp"
}
}
}Установка finwire.pl MCP в VS Code CLI
$ code --add-mcp '{"name":"api","type":"http","url":"https://public-api.finwire.pl/mcp"}'Установка finwire.pl MCP в Codex
$ codex mcp add api --url https://public-api.finwire.pl/mcpУстановка finwire.pl MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.api] url = "https://public-api.finwire.pl/mcp"
Установка finwire.pl MCP в Gemini CLI
$ gemini mcp add -s user --transport http api https://public-api.finwire.pl/mcpУстановка finwire.pl MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://public-api.finwire.pl/mcp",
"type": "http"
}
}
}Переменные окружения и API-ключи не требуются.Руководства по настройке:Claude CodeCursorVS CodeClaude Desktop
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →58/100
Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
Показать эту оценку в вашем README
- Связанный и доступный исходный репозиторийfinwire-pl/api is public and reachablegithub.com/finwire-pl/api ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-11-13github.com/finwire-pl/api ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 425 msПройдено
README
Открыть на 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
Как добавить finwire.pl MCP в Claude Code?
Выполните claude mcp add --transport http api https://public-api.finwire.pl/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить finwire.pl MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Требуется ли API-ключ для этого API?
Нет, API бесплатно и не требует API-ключа или регистрации.
Доступны ли данные по WIBOR или POLSTR?
Нет, данные WIBOR и POLSTR недоступны, так как они являются бенчмарками GPW и требуют специального лицензионного соглашения на рыночные данные.
К каким данным по недвижимости я могу получить доступ?
Вы можете получить доступ к ценам на сделки с квартирами на основе нотариальных актов, ценам на аренду, доходности от аренды и данным о предложении жилья.