Model Context Protocol
English

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

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

12

Kursy bieżące, świece dzienne i śróddzienne, ruchy sesji, puls sektorów i anomalie wolumenu na GPW.

  • compare_symbols

    Poró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_peers

    Zagraniczne odpowiedniki są niedostępne w produkcie GPW-only. Narzędzie zwraca pustą listę i wyjaśnienie polityki rynku.

  • get_dividends

    Historia 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_quote

    Kwotowanie w trakcie sesji: cena, otwarcie, zakres dnia, zmiana wobec zamknięcia.

  • get_market_anomalies

    Ruchy 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_history

    Dzienna historia cen GPW z bazy, do 500 świec, ze źródłem, datami, skalą cen i jawnym przycięciem.

  • get_spot_price

    Bieżą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_companies

    Wyszukiwanie spółek GPW po nazwie, tickerze, aliasie lub ISIN, bez konta i klucza.

  • sector_pulse_pl

    Puls 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_now

    Co się dziś rusza na rynku - największe zmiany sesji.

Raporty i komunikaty spółek

16

Raporty ESPI i EBI, dane kwartalne wyciągnięte z dokumentów, kalendarz publikacji, konferencje wynikowe i walne zgromadzenia.

  • get_analysis_discounts

    Narzę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_reports

    Raporty analityczne PWPA o spółce z 90 dni: data, dom maklerski, źródło i odnośniki, bez rekomendacji i ceny docelowej.

  • get_company_analysis

    Podglą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_reminders

    Konferencje wynikowe śledzonych spółek zapowiedziane w depeszach.

  • get_conference_summary

    Streszczenie konferencji wynikowej: cytaty zarządu, prognozy i sygnały ostrzegawcze.

  • get_earnings_calendar

    Kalendarz zbliżających się raportów okresowych.

  • get_earnings_deepdive

    Pogłębione omówienie raportu kwartalnego: co zaskoczyło, co niepokoi, co zapowiedział zarząd.

  • get_espi_stream

    Strumień komunikatów ESPI całego rynku albo obserwowanych spółek, z wyszukiwaniem i stronicowaniem.

  • get_financial_ratios

    Marże kwartalne i udział kapitału w aktywach, z formułą, okresem raportu i powodami braku wskaźnika.

  • get_news_history

    Historia depesz o spółce razem z ich oceną.

  • get_public_dividends

    Znane uchwały dywidendowe GPW z komunikatów WZA, z kwotą na akcję, walutą, terminami i źródłem.

  • get_public_earnings_calendar

    Publiczny kalendarz zapowiedzianych raportów GPW na najbliższe 90 dni, ze źródłem i datą pobrania.

  • get_quarterly_kpis

    Wyniki kwartalne spółki: przychód, zysk, bilans i przepływy, wraz z oceną jakości każdego wiersza.

  • get_report_event

    Jeden 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_summary

    Streszczenie walnego zgromadzenia akcjonariuszy.

Oceny i rankingi

11

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_candidates

    Spadki kursu zestawione z wewnętrzną oceną, średnią z 200 sesji i zmiennością, bez potwierdzonej przewagi w wyborze momentu zakupu.

  • find_opportunities

    Narzędzie wycofane. Alternatywy: get_top_opportunities lub screen_stocks.

  • find_overheat_candidates

    Wzrosty kursu zestawione z wewnętrzną oceną, średnią z 200 sesji i zmiennością, bez potwierdzonej przewagi w wyborze momentu sprzedaży.

  • get_ranking_performance

    Jak ranking sprawdzał się w przeszłości.

  • get_stock_rankings

    Ranking spółek GPW według wybranego kryterium.

  • get_sygnal_score

    Ocena 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_opportunities

    Ta sama lista spółek spoza portfela co w kafelku Top okazje na pulpicie.

  • rank_revenue_growth

    Ranking wzrostu przychodów.

  • rank_thematic

    Ranking spółek w obrębie wybranego motywu inwestycyjnego.

  • run_predictive_scan

    Skan spółek pod kątem zbliżających się raportów i przewidywanego zaskoczenia.

  • screen_stocks

    Przesiew 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

6

Prognozy przychodu i zysku na następny kwartał wraz z ich rozliczeniem po publikacji raportu oraz drivery makro.

  • get_drivers

    Bieżące czynniki makro: surowce, waluty, stopy, nastroje na rynku amerykańskim.

  • get_evaluation_outcomes

    Rozliczenie dawnych alertów po cenach: co się sprawdziło, a co nie, na tle indeksu.

  • get_factor_context

    Zmiana wybranego czynnika makro dla spółki z udokumentowanym źródłem i ekspozycją.

  • get_forecast

    Prognoza 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_accuracy

    Historyczna celność modeli prognostycznych i to, czy model przeszedł bramkę jakości.

  • macro_attribution

    Co najprawdopodobniej stało za ostatnim ruchem WIG20.

Portfel i alokacja

18

Pozycje z wielu rachunków, stopa zwrotu, zmienność, koncentracja i rozjazd wobec docelowych wag.

  • analyze_thesis_exposure

    Rozkład portfela na ogniwa łańcucha wartości AI - gdzie masz ekspozycję, a gdzie dziurę.

  • compare_portfolio_risk_reward

    Narzę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_review

    Potwierdzenie tezy po raporcie bez zmian, jak „Tak, bez zmian” w aplikacji.

  • get_concentration_risk

    Ile portfela stoi na jednej spółce, sektorze i rynku.

  • get_my_theses

    Twoje tezy ze spółek z portfela i obserwowanych: stan, warunki, oś czasu i prośba o przegląd po raporcie.

  • get_portfolio_analytics

    Krzywa 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_context

    Obraz portfela użytkownika: pozycje, gotówka, watchlista z oceną analityka i powodem obserwacji, cele alokacji. Analiza i wycena wymagają PRO.

  • get_portfolio_stats

    Statystyki ryzyka i wyniku portfela liczone z historii transakcji.

  • get_portfolio_value_history

    Historia wartości portfela w czasie.

  • get_total_portfolio_view

    Portfel zsumowany ze wszystkich rachunków maklerskich, przeliczony na jedną walutę.

  • modify_holdings

    Ręczna zmiana pozycji w portfelu.

  • modify_watchlist

    Dodanie lub usunięcie spółki z watchlisty.

  • recommend_diversification

    Wagi sektorów portfela i sektory poniżej progu udziału. Dobór kandydatów wycofany.

  • recommend_position_size

    Kalkulator wielkości pozycji z budżetu ryzyka, gotówki, zmienności i limitu koncentracji. Bez prognozy zwrotu.

  • set_cash_balance

    Ustawienie salda gotówki na rachunku.

  • set_thesis

    Zapis albo usunięcie Twojej tezy spółki: rodzaj, zdanie i warunki, na tych samych zasadach co edytor w aplikacji.

  • submit_portfolio_snapshot

    Wgranie stanu rachunku z zewnętrznego brokera.

  • suggest_order_size

    Wielkość zlecenia z uwzględnieniem dostępnej gotówki na konkretnym rachunku.

Transakcje i podatki

5

Historia realizacji, zysk zrealizowany, jakość egzekucji wobec VWAP i wyszukiwanie strat do rozliczenia podatkowego.

  • analyze_trade_outcome

    Rozliczenie pojedynczej transakcji: co wyszło, a co nie.

  • find_tlh_opportunities

    Pozycje ze stratą, którą da się odliczyć od podatku w tym roku.

  • get_realized_pnl

    Zrealizowany wynik od początku roku i okazje do rozliczenia strat podatkowych.

  • get_transaction_history

    Historia transakcji użytkownika, od najnowszej.

  • submit_broker_transactions

    Wgranie historii transakcji do rozliczeń i podatków.

Sygnały, alerty i zdarzenia

20

Sygnały na spółkach z rozliczeniem trafności, alerty, zdarzenia wyceniane przez rynek i własne reguły decyzyjne.

  • cancel_priced_event

    Odwołanie śledzonego zdarzenia.

  • create_decision_rule

    Utworzenie reguły decyzyjnej, która ma pilnować warunku za Ciebie.

  • delete_decision_rule

    Usunięcie reguły decyzyjnej.

  • get_activity_feed

    Ostatnie zdarzenia na Twoim koncie.

  • get_alert_delivery_stats

    Statystyki dostarczania alertów: ile poszło, ile się nie udało.

  • get_alerts

    Alerty dostarczone temu użytkownikowi: depesze, tezy, reguły i alarmy cen, z filtrami po spółce, rodzaju, klasyfikacji i rynku.

  • get_asset_signals

    Szanse i ryzyka wykryte automatycznie dla spółki, każde z podpiętym dowodem w danych.

  • get_dividend_settlement_history

    Rozliczenie własnej śledzonej dywidendy: bieżąca wersja i wcześniejsze korekty.

  • get_my_alert_performance

    Skuteczność alertów, które dostałeś: ile się sprawdziło.

  • get_priced_events

    Lista śledzonych zdarzeń wycenionych.

  • get_signal_prediction_performance

    Celność liczbowych przewidywań ruchu ceny: trafienia, kierunek, średni błąd.

  • historical_event_hit_rate

    Jak podobne zdarzenia wpływały na cenę w przeszłości.

  • list_decision_rule_proposals

    Propozycje reguł decyzyjnych wynikające z Twojego zachowania.

  • list_decision_rules

    Lista Twoich reguł decyzyjnych.

  • list_webhook_events

    Zdarzenia z webhooka - do sprawdzenia, czy TradingView dochodzi do Agenta Rynku.

  • resolve_priced_event_now

    Natychmiastowe rozliczenie zdarzenia po bieżącej cenie.

  • submit_alert_feedback

    Ocena alertu - ten sam sygnał, co kciuki w Telegramie.

  • track_priced_event

    Zapisanie zdarzenia, którego wpływ na cenę chcesz rozliczyć później.

  • update_decision_rule

    Zmiana reguły decyzyjnej.

  • update_priced_event

    Zmiana szczegółów śledzonego zdarzenia.

Ryzyko rynkowe

4

Poziom ryzyka rynkowego, tematy ryzyka i zdarzenia mogące uderzyć w portfel.

  • get_event_risks

    Kalendarz zdarzeń makro, które mogą poruszyć rynkiem.

  • get_risk_dashboard

    Zbiorczy obraz ryzyka rynkowego: jego poziom i aktywne motywy razem.

  • get_risk_regime

    Ryzyko rynkowe: aktualna ocena pasma albo jawny brak używalnych danych.

  • get_risk_themes

    Motywy ryzyka aktywne w tej chwili.

Obligacje Catalyst

3

Serie obligacji, arkusz zleceń i kalkulator wcześniejszego wykupu.

  • calculate_early_redemption

    Rachunek opłacalności wcześniejszego wykupu obligacji.

  • get_bond_orderbook

    Arkusz zleceń dla obligacji - na razie niedostępny, zwraca informację o odroczeniu.

  • get_bond_series

    Wyszukiwanie serii obligacji z Catalyst po emitencie, marży i terminie wykupu.

Konto, odprawa i diagnostyka

11

Dzienna odprawa rynkowa, rozmowa z asystentem, ustawienia agenta oraz stan potoku danych.

  • claim_feature_request

    Wzięcie zgłoszenia do pracy albo oddanie go do kolejki.

  • get_codex_pipeline_stats

    Statystyki potoku ekstrakcji danych ze sprawozdań.

  • get_daily_brief

    Odprawa na dziś: co się zmieniło w Twoim portfelu i na watchliście.

  • get_outcome_settlement_health

    Stan rozliczania wyników alertów i prognoz.

  • get_pipeline_health

    Stan potoków danych: świeżość źródeł, opóźnienia, awarie.

  • list_feature_requests

    Lista zgłoszeń i ich stan.

  • modify_chat_settings

    Ustawienia powiadomień: próg istotności, kanały, wyciszone klasy alertów.

  • modify_profile

    Zmiana profilu inwestora.

  • query_companion

    Zapytanie do asystenta Agenta Rynku w języku naturalnym.

  • set_agent_prefs

    Ustawienia zachowania agenta.

  • submit_feature_request

    Zgł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ń.