Serwer MCP z danymi polskiej giełdy
Wyniki kwartalne GPW, marże, wyszukiwanie spółek, kalendarz raportów, dywidendy z WZA i decyzji emitenta oraz dzienna historia cen: 6 narzędzi bez konta i klucza. Wyniki pochodzą z raportów emitentów i komunikatów GPW, ceny z zapisanej historii dziennej. Źródła, daty i braki są jawne. Pełny katalog liczy 106 narzędzi; pozostałe funkcje wymagają klucza. Działa z klientami protokołu MCP przez HTTP.
Adres serwera: https://agentrynku.pl/api/mcp
Dane publiczne bez konta
Wyniki kwartalne GPW, wskaźniki z raportów, wyszukiwanie spółek, kalendarz publikacji, znane uchwały dywidendowe WZA i dzienna historia cen są dostępne bez klucza. Dane mają okresy, źródła i informację o brakach oraz wstrzymaniu jakości.
Transport HTTP
Podłącz klienta MCP do https://agentrynku.pl/api/mcp. Do danych publicznych wystarczy adres, bez nagłówka Authorization. Opcjonalna paczka npm jest mostem dla klientów uruchamiających lokalne polecenie.
Pozostałe funkcje z kluczem
Klucz z ustawień konta otwiera katalog zgodny z jego uprawnieniami. Portfel i alerty są przypisane do konta. Zakresy odczytu (read:*) i zapisu (write:portfolio, write:watchlist, write:profile, write:alerts) wybierasz osobno; klucz bez zakresów zapisu niczego nie zmieni na koncie.
Jak podłączyć
Do danych publicznych wystarczy adres HTTP. KonfiguracjamcpServers poniżej jest dla klientów, które czytają ten format. Nie podawaj nagłówka Authorization.
{
"mcpServers": {
"agentrynku": {
"type": "http",
"url": "https://agentrynku.pl/api/mcp"
}
}
}Klient, który nie łączy się z adresem HTTP, tylko uruchamia lokalne polecenie, podłączysz paczką agentrynku-mcp z npm: npx -y agentrynku-mcp. Klucz w zmiennej AGENTRYNKU_API_KEY jest opcjonalny. Parametry, przykładowe odpowiedzi i konfigurację klientów znajdziesz w dokumentacji serwera MCP, a kod mostu w repozytorium na GitHubie.
Więcej o pracy z agentem AI na danych z GPW przeczytasz na blogu, we wpisie jak używać agenta AI na giełdzie.
Publiczne narzędzia
get_quarterly_kpissearch_gpw_companiesget_public_earnings_calendarget_financial_ratiosget_public_dividendsget_public_price_history
Wyniki: do 20 kwartałów, wyszukiwanie: do 20 spółek, kalendarz: do 90 dni. Dywidendy obejmują znane komunikaty WZA i zakwalifikowane decyzje emitenta, w tym zaliczki. Zatwierdzony termin nie potwierdza wykonania wypłaty. Dzienna historia cen z bazy jest publiczna, do 500 świec na żądanie; intraday wymaga klucza. Ograniczamy tempo żądań; odpowiedź 429 podaje czas ponowienia.
Pozostałe funkcje z kluczem
Do portfela, alertów, prognoz i notowań załóż konto, wygeneruj klucz w ustawieniachi dodaj nagłówek Authorization: Bearer TWOJ_KLUCZ. Przy tworzeniu klucza wybierasz jego zakresy. Zakresy odczytu (read:*) otwierają portfel, alerty, prognozy, analizy i czynniki rynkowe. Zapis jest osobno: write:portfolio (pozycje, gotówka, transakcje, śledzone zdarzenia, reguły), write:watchlist, write:profile i write:alerts (ustawienia czatu, ocena alertów). Klucz bez zakresów zapisu niczego nie zmieni na koncie.
O co zapytać agenta
- „Znajdź KGHM i pokaż ostatni raport kwartalny ze źródłem.”
- „Oblicz marżę EBITDA z tego raportu.”
- „Jakie raporty spółek GPW są zaplanowane w ciągu 30 dni?”
- „Pokaż znane uchwały dywidendowe Agory.”
Czego serwer NIE robi
- Nie składa zleceń i nie łączy się z rachunkiem maklerskim.
- Nie daje porady inwestycyjnej - oddaje dane i wyliczenia.
- Nie zgaduje: przy brakujących danych zwraca odmowę z powodem, a nie liczbę zastępczą.
Limity planów FREE i PRO
Serwer MCP służy do tego, żeby Twój agent pomagał Ci w codziennym inwestowaniu, a nie do hurtowego pobierania danych. Głębokość historii dla klientów zewnętrznych: komunikaty ESPI do 30 dni wstecz, newsy do 90 dni, rankingi historyczne tylko z ostatnich 30 dni; starszy zakres jest przycinany z informacją w odpowiedzi. Narzędzia wielu spółek (get_asset_signals, get_earnings_deepdive, get_intraday_quote, compare_symbols, get_drivers) liczą się w puli wywołań konta per spółka.
Narzędzia danych publicznych nie zużywają puli konta, także wywołane z kluczem (poza get_quarterly_kpis, który z kluczem zwraca pełniejsze dane). Mają osobny dzienny limit wywołań: 200 bez konta, 1000 z kluczem w FREE i 1500 w PRO; odnawia się o północy czasu warszawskiego. Bez konta limit liczymy dla adresu, z którego łączy się klient (nie zmienia go inny User-Agent). initialize i tools/list nie są liczone. Pozostałe wywołania z kluczem zużywają pulę MCP: 100 wywołań miesięcznie w FREE albo 10 000 w PRO.query_companion zużywa też jedną wiadomość z puli AI. W okresie próbnym PRO pula MCP wynosi 100 wywołań na dobę (odnawiana o północy czasu warszawskiego), a dzienny limit narzędzi danych publicznych jest taki jak w FREE; pełne limity PRO obowiązują po pierwszej płatności.Wykorzystanie i datę resetu zobaczysz w limitach konta.
Po wyczerpaniu puli serwer zwraca błąd JSON-RPC -32000 z polamicategory, used, limit,plan, resetAt i upgradeUrl. Zakres planów i ceny są w cenniku.
Wszystkie narzędzia (106)
Bez klucza klient widzi publiczne narzędzia wymienione wyżej. Z kluczem katalog jest filtrowany według jego uprawnień. Opisy poniżej są skrótem; jednostki i bramki jakości są również w odpowiedziach danych.
Notowania i rynek
Kursy bieżące, świece dzienne i śróddzienne, ruchy sesji, puls sektorów i anomalie wolumenu na GPW.
compare_symbolsPorównanie kilku spółek obok siebie. W PRO także opis P/E spółek GPW na tle własnej historii, bez prognozy kursu.
get_cross_market_peersZagraniczne odpowiedniki są niedostępne w produkcie GPW-only. Narzędzie zwraca pustą listę i wyjaśnienie polityki rynku.
get_dividendsHistoria i znane przyszłe dywidendy spółki, z kwotą, datą, źródłem i świeżością.
get_intraday_candlesŚwiece godzinowe z bieżącej i poprzednich sesji.
get_intraday_quoteKwotowanie w trakcie sesji: cena, otwarcie, zakres dnia, zmiana wobec zamknięcia.
get_market_anomaliesRuchy cen odstające od zwykłej zmienności spółki, wyłapane automatycznie.
get_price_seriesŚwiece OHLC i zmienność zrealizowana - do stop-lossów i wielkości pozycji.
get_public_price_historyDzienna historia cen GPW z bazy, do 500 świec, ze źródłem, datami, skalą cen i jawnym przycięciem.
get_spot_priceBieżąca cena jednej spółki, z informacją, czy pochodzi z zamknięcia, czy z kwotowania w trakcie sesji. Także miedź COMEX, srebro i USD/PLN.
search_gpw_companiesWyszukiwanie spółek GPW po nazwie, tickerze, aliasie lub ISIN, bez konta i klucza.
sector_pulse_plPuls sektorów GPW z datą sesji, pokryciem bieżącej lub ostatniej sesji i informacją o różnicy dat sektorów oraz indeksów.
whats_moving_nowCo się dziś rusza na rynku - największe zmiany sesji.
Raporty i komunikaty spółek
Raporty ESPI i EBI, dane kwartalne wyciągnięte z dokumentów, kalendarz publikacji, konferencje wynikowe i walne zgromadzenia.
get_analysis_discountsNarzędzie wycofane. Użyj get_forecast: opis P/E na tle własnej historii spółki dostępny w PRO, nie prognoza kursu.
get_analyst_reportsRaporty analityczne PWPA o spółce z 90 dni: data, dom maklerski, źródło i odnośniki, bez rekomendacji i ceny docelowej.
get_company_analysisPodgląd analizy fundamentalnej spółki. Pełna treść jest dostępna w PRO.
get_company_dossierŹródłowa pamięć decyzyjna: trwałe przewagi, słabości, otwarte ryzyka, potwierdzone wzorce i kontekst biznesowy.
get_conference_remindersKonferencje wynikowe śledzonych spółek zapowiedziane w depeszach.
get_conference_summaryStreszczenie konferencji wynikowej: cytaty zarządu, prognozy i sygnały ostrzegawcze.
get_earnings_calendarKalendarz zbliżających się raportów okresowych.
get_earnings_deepdivePogłębione omówienie raportu kwartalnego: co zaskoczyło, co niepokoi, co zapowiedział zarząd.
get_espi_streamStrumień komunikatów ESPI całego rynku albo obserwowanych spółek, z wyszukiwaniem i stronicowaniem.
get_financial_ratiosMarże kwartalne i udział kapitału w aktywach, z formułą, okresem raportu i powodami braku wskaźnika.
get_news_historyHistoria depesz o spółce razem z ich oceną.
get_public_dividendsZnane uchwały dywidendowe GPW z komunikatów WZA, z kwotą na akcję, walutą, terminami i źródłem.
get_public_earnings_calendarPubliczny kalendarz zapowiedzianych raportów GPW na najbliższe 90 dni, ze źródłem i datą pobrania.
get_quarterly_kpisWyniki kwartalne spółki: przychód, zysk, bilans i przepływy, wraz z oceną jakości każdego wiersza.
get_report_eventJeden raport kwartalny jako zdarzenie: wyniki, reakcja kursu na publikację, rozliczenia, zmiany i otwarte tezy, z wiekiem i źródłem liczb oraz linkami oryginalnych załączników emitenta.
get_wza_summaryStreszczenie walnego zgromadzenia akcjonariuszy.
Oceny i rankingi
Ocena Agenta Rynku, czyli ocena rankingowa z opublikowanego rankingu, opis spółki w wymiarach, rankingi całego rynku i skanery szukające konkretnych układów.
find_dip_candidatesSpadki kursu zestawione z wewnętrzną oceną, średnią z 200 sesji i zmiennością, bez potwierdzonej przewagi w wyborze momentu zakupu.
find_opportunitiesNarzędzie wycofane. Alternatywy: get_top_opportunities lub screen_stocks.
find_overheat_candidatesWzrosty kursu zestawione z wewnętrzną oceną, średnią z 200 sesji i zmiennością, bez potwierdzonej przewagi w wyborze momentu sprzedaży.
get_ranking_performanceJak ranking sprawdzał się w przeszłości.
get_stock_rankingsRanking spółek GPW według wybranego kryterium.
get_sygnal_scoreOcena Agenta Rynku spółki z GPW: miejsce w rankingu ogólnym (jak na /rankings) albo powód, dla którego spółka jest poza rankingiem. Do tego wymiary z dowodami, w tym płynność pokazywana osobno.
get_top_opportunitiesTa sama lista spółek spoza portfela co w kafelku Top okazje na pulpicie.
rank_revenue_growthRanking wzrostu przychodów.
rank_thematicRanking spółek w obrębie wybranego motywu inwestycyjnego.
run_predictive_scanSkan spółek pod kątem zbliżających się raportów i przewidywanego zaskoczenia.
screen_stocksPrzesiew spółek GPW po kapitalizacji, dynamice EBITDA lub przychodów r/r, zakupach insiderów i wybiciu z maksimum na wolumenie; osobno brak danych i EBITDA nieadekwatna dla banków.
Prognozy wyników
Prognozy przychodu i zysku na następny kwartał wraz z ich rozliczeniem po publikacji raportu oraz drivery makro.
get_driversBieżące czynniki makro: surowce, waluty, stopy, nastroje na rynku amerykańskim.
get_evaluation_outcomesRozliczenie dawnych alertów po cenach: co się sprawdziło, a co nie, na tle indeksu.
get_factor_contextZmiana wybranego czynnika makro dla spółki z udokumentowanym źródłem i ekspozycją.
get_forecastPrognoza wyników spółki na najbliższe kwartały. W PRO także P/E na tle własnej historii spółki: opis wskaźnika, nie prognoza kursu.
get_forecast_accuracyHistoryczna celność modeli prognostycznych i to, czy model przeszedł bramkę jakości.
macro_attributionCo najprawdopodobniej stało za ostatnim ruchem WIG20.
Portfel i alokacja
Pozycje z wielu rachunków, stopa zwrotu, zmienność, koncentracja i rozjazd wobec docelowych wag.
analyze_thesis_exposureRozkład portfela na ogniwa łańcucha wartości AI - gdzie masz ekspozycję, a gdzie dziurę.
compare_portfolio_risk_rewardNarzędzie wycofane. Użyj get_forecast: opis P/E na tle własnej historii spółki dostępny w PRO, nie prognoza kursu.
confirm_thesis_reviewPotwierdzenie tezy po raporcie bez zmian, jak „Tak, bez zmian” w aplikacji.
get_concentration_riskIle portfela stoi na jednej spółce, sektorze i rynku.
get_my_thesesTwoje tezy ze spółek z portfela i obserwowanych: stan, warunki, oś czasu i prośba o przegląd po raporcie.
get_portfolio_analyticsKrzywa kapitału portfela dzień po dniu, ze stopą zwrotu, obsunięciem, zmiennością i porównaniem z WIG-iem lub S&P 500.
get_portfolio_contextObraz portfela użytkownika: pozycje, gotówka, watchlista z oceną analityka i powodem obserwacji, cele alokacji. Analiza i wycena wymagają PRO.
get_portfolio_statsStatystyki ryzyka i wyniku portfela liczone z historii transakcji.
get_portfolio_value_historyHistoria wartości portfela w czasie.
get_total_portfolio_viewPortfel zsumowany ze wszystkich rachunków maklerskich, przeliczony na jedną walutę.
modify_holdingsRęczna zmiana pozycji w portfelu.
modify_watchlistDodanie lub usunięcie spółki z watchlisty.
recommend_diversificationWagi sektorów portfela i sektory poniżej progu udziału. Dobór kandydatów wycofany.
recommend_position_sizeKalkulator wielkości pozycji z budżetu ryzyka, gotówki, zmienności i limitu koncentracji. Bez prognozy zwrotu.
set_cash_balanceUstawienie salda gotówki na rachunku.
set_thesisZapis albo usunięcie Twojej tezy spółki: rodzaj, zdanie i warunki, na tych samych zasadach co edytor w aplikacji.
submit_portfolio_snapshotWgranie stanu rachunku z zewnętrznego brokera.
suggest_order_sizeWielkość zlecenia z uwzględnieniem dostępnej gotówki na konkretnym rachunku.
Transakcje i podatki
Historia realizacji, zysk zrealizowany, jakość egzekucji wobec VWAP i wyszukiwanie strat do rozliczenia podatkowego.
analyze_trade_outcomeRozliczenie pojedynczej transakcji: co wyszło, a co nie.
find_tlh_opportunitiesPozycje ze stratą, którą da się odliczyć od podatku w tym roku.
get_realized_pnlZrealizowany wynik od początku roku i okazje do rozliczenia strat podatkowych.
get_transaction_historyHistoria transakcji użytkownika, od najnowszej.
submit_broker_transactionsWgranie historii transakcji do rozliczeń i podatków.
Sygnały, alerty i zdarzenia
Sygnały na spółkach z rozliczeniem trafności, alerty, zdarzenia wyceniane przez rynek i własne reguły decyzyjne.
cancel_priced_eventOdwołanie śledzonego zdarzenia.
create_decision_ruleUtworzenie reguły decyzyjnej, która ma pilnować warunku za Ciebie.
delete_decision_ruleUsunięcie reguły decyzyjnej.
get_activity_feedOstatnie zdarzenia na Twoim koncie.
get_alert_delivery_statsStatystyki dostarczania alertów: ile poszło, ile się nie udało.
get_alertsAlerty dostarczone temu użytkownikowi: depesze, tezy, reguły i alarmy cen, z filtrami po spółce, rodzaju, klasyfikacji i rynku.
get_asset_signalsSzanse i ryzyka wykryte automatycznie dla spółki, każde z podpiętym dowodem w danych.
get_dividend_settlement_historyRozliczenie własnej śledzonej dywidendy: bieżąca wersja i wcześniejsze korekty.
get_my_alert_performanceSkuteczność alertów, które dostałeś: ile się sprawdziło.
get_priced_eventsLista śledzonych zdarzeń wycenionych.
get_signal_prediction_performanceCelność liczbowych przewidywań ruchu ceny: trafienia, kierunek, średni błąd.
historical_event_hit_rateJak podobne zdarzenia wpływały na cenę w przeszłości.
list_decision_rule_proposalsPropozycje reguł decyzyjnych wynikające z Twojego zachowania.
list_decision_rulesLista Twoich reguł decyzyjnych.
list_webhook_eventsZdarzenia z webhooka - do sprawdzenia, czy TradingView dochodzi do Agenta Rynku.
resolve_priced_event_nowNatychmiastowe rozliczenie zdarzenia po bieżącej cenie.
submit_alert_feedbackOcena alertu - ten sam sygnał, co kciuki w Telegramie.
track_priced_eventZapisanie zdarzenia, którego wpływ na cenę chcesz rozliczyć później.
update_decision_ruleZmiana reguły decyzyjnej.
update_priced_eventZmiana szczegółów śledzonego zdarzenia.
Ryzyko rynkowe
Poziom ryzyka rynkowego, tematy ryzyka i zdarzenia mogące uderzyć w portfel.
get_event_risksKalendarz zdarzeń makro, które mogą poruszyć rynkiem.
get_risk_dashboardZbiorczy obraz ryzyka rynkowego: jego poziom i aktywne motywy razem.
get_risk_regimeRyzyko rynkowe: aktualna ocena pasma albo jawny brak używalnych danych.
get_risk_themesMotywy ryzyka aktywne w tej chwili.
Obligacje Catalyst
Serie obligacji, arkusz zleceń i kalkulator wcześniejszego wykupu.
calculate_early_redemptionRachunek opłacalności wcześniejszego wykupu obligacji.
get_bond_orderbookArkusz zleceń dla obligacji - na razie niedostępny, zwraca informację o odroczeniu.
get_bond_seriesWyszukiwanie serii obligacji z Catalyst po emitencie, marży i terminie wykupu.
Konto, odprawa i diagnostyka
Dzienna odprawa rynkowa, rozmowa z asystentem, ustawienia agenta oraz stan potoku danych.
claim_feature_requestWzięcie zgłoszenia do pracy albo oddanie go do kolejki.
get_codex_pipeline_statsStatystyki potoku ekstrakcji danych ze sprawozdań.
get_daily_briefOdprawa na dziś: co się zmieniło w Twoim portfelu i na watchliście.
get_outcome_settlement_healthStan rozliczania wyników alertów i prognoz.
get_pipeline_healthStan potoków danych: świeżość źródeł, opóźnienia, awarie.
list_feature_requestsLista zgłoszeń i ich stan.
modify_chat_settingsUstawienia powiadomień: próg istotności, kanały, wyciszone klasy alertów.
modify_profileZmiana profilu inwestora.
query_companionZapytanie do asystenta Agenta Rynku w języku naturalnym.
set_agent_prefsUstawienia zachowania agenta.
submit_feature_requestZgłoszenie błędu, pomysłu albo brakujących danych do zespołu Agenta Rynku.
Brakuje narzędzia?
Serwer ma narzędzie submit_feature_request, więc Twój agent może zgłosić brak sam, w trakcie pracy, bez wychodzenia z rozmowy. Zgłoszenia trafiają na tę samą tablicę, z której powstaje kolejka wdrożeń.