Agent Rynku MCP: Warsaw Stock Exchange (GPW) data for your AI agent

Agent Rynku is a hosted Model Context Protocol server with 93 tools for the Polish stock market: live and historical quotes, ESPI/EBI filings with an assessment of each one, quarterly KPIs extracted from company documents, earnings forecasts with a track record, and portfolio analytics in PLN.

Connect it to Claude, Cursor, or any MCP client and ask things like:

• "What did KGHM report today, and how does it compare with the forecast?"
• "Show WIG20 companies after their latest results."
• "Which of my positions are above 20% concentration?"
• "How much tax will I owe on this year's sales?"

Polski opis jest niżej.

Quick start

1. Get an API key. Create a free account at agentrynku.pl and generate a key in settings. The free account covers unlimited data tool calls; only the LLM-backed companion queries are metered. The bridge below makes one check call per start to verify the key.

2. Connect your client. The server speaks Streamable HTTP at:

https://agentrynku.pl/api/mcp

with the header Authorization: Bearer YOUR_KEY.

Claude Code

claude mcp add --transport http agentrynku https://agentrynku.pl/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor and other clients with remote HTTP support

{
  "mcpServers": {
    "agentrynku": {
      "type": "http",
      "url": "https://agentrynku.pl/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop and other clients that only run local commands

This package is a small stdio bridge to the hosted server (it uses mcp-remote):

{
  "mcpServers": {
    "agentrynku": {
      "command": "npx",
      "args": ["-y", "agentrynku-mcp"],
      "env": { "AGENTRYNKU_API_KEY": "YOUR_KEY" }
    }
  }
}

More configs in examples/.

Try before signing up: initialize and tools/list work without a key, so you can see the full catalogue first:

curl -s https://agentrynku.pl/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What is inside

Area	Tools	Examples
Quotes and market	10	get_spot_price, get_intraday_quote, get_price_series, whats_moving_now, sector_pulse_pl
Filings and reports	10	get_news_history, get_report_event, get_quarterly_kpis, get_company_analysis, get_earnings_calendar
Scores, screens and rankings	10	get_stock_rankings, get_sygnal_score, find_opportunities, find_dip_candidates, run_predictive_scan
Forecasts and drivers	6	get_forecast, get_forecast_accuracy, get_drivers, get_factor_context
Signals, alerts and events	19	get_alerts, get_asset_signals, track_priced_event, create_decision_rule
Portfolio and allocation	15	get_portfolio_context, get_concentration_risk, recommend_position_size, modify_watchlist
Transactions and tax	5	get_realized_pnl, get_transaction_history, find_tlh_opportunities
Market risk	4	get_risk_regime, get_risk_dashboard, get_event_risks
Catalyst bonds	3	get_bond_series, get_bond_orderbook, calculate_early_redemption
Account, brief and diagnostics	11	get_daily_brief, query_companion, set_agent_prefs

Full list with descriptions: TOOLS.md. Portfolio tools read the portfolio you keep in your Agent Rynku account; key scopes decide which tools a key can see.

Scope and limits

• Polish equities only (GPW main market and NewConnect), deliberately: filings are read in Polish, and extraction is built for the formats the GPW actually uses.
• Tool names are English. Tool descriptions, the server's instructions, the web app and the source material (filings, reports) are Polish.
• The server does not place orders, does not connect to a brokerage account and does not give investment advice. When data is missing it returns a refusal with a reason, never a substitute number.
• Intraday quotes come from a delayed GPW feed (typically around 25 minutes behind).

Links

• Server page and full catalogue: agentrynku.pl/mcp (English)
• Methodology of the assessments: agentrynku.pl/metodologia
• Issues and questions: GitHub issues

Po polsku

Agent Rynku to serwer MCP z danymi Giełdy Papierów Wartościowych w Warszawie: 93 narzędzia, przez które Twój agent czyta notowania i świece śróddzienne, raporty ESPI i EBI z oceną każdego komunikatu, dane kwartalne wyciągnięte z dokumentów spółek, prognozy wyników z rozliczeniem trafności oraz analitykę portfela w złotych.

1. Załóż darmowe konto na agentrynku.pl i wygeneruj klucz API w ustawieniach.
2. Podłącz klienta pod adres https://agentrynku.pl/api/mcp z nagłówkiem Authorization: Bearer TWOJ_KLUCZ (przykłady wyżej). Klient, który umie uruchomić tylko lokalne polecenie (np. Claude Desktop), użyje tej paczki: npx -y agentrynku-mcp ze zmienną AGENTRYNKU_API_KEY.

Serwer nie składa zleceń, nie łączy się z rachunkiem maklerskim i nie daje porady inwestycyjnej. Pełny katalog narzędzi po polsku: agentrynku.pl/mcp i TOOLS.md.

License

The bridge code and this documentation are MIT licensed. Data returned by the server is subject to the Agent Rynku terms.