Agent Rynku - Warsaw Stock Exchange (GPW) data for your agent

Agent Rynku MCP：エージェント向けワルシャワ証券取引所データ

アカウントを作成せずに、ホスト型 MCP サーバーを通じてGPW企業の財務情報を利用できます。Agent Rynku は、報告期間、通貨、情報源、品質チェックを返します。データがない場合は、その旨が明示されます。

すべての公開ツールのパラメーターと実際の応答を記載したドキュメント：agentrynku.pl/docs。

APIキーなしで接続する

エンドポイントはStreamable HTTPを使用します：

https://agentrynku.pl/api/mcp

この設定形式を読み取るクライアントの場合：

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

ローカルコマンドを起動するクライアントの場合、このパッケージはmcp-remoteを使用してstdioをホスト型サーバーに接続します。Node 20.18.1以降が必要です：

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

公開データの利用に、Authorizationヘッダーや環境変数は必要ありません。

公開ツール

ツール	返される内容	リクエスト制限
search_gpw_companies	名前、ティッカー、別名、ISINによるGPW企業の検索結果。正式なシンボルと企業URLを含みます	20件
get_quarterly_kpis	四半期財務情報、報告範囲、通貨、単位、情報源、品質ゲート	20四半期
get_financial_ratios	四半期の利益率と自己資本／総資産比率。計算式と値を取得できない理由を含みます	20四半期
get_public_earnings_calendar	GPW全体の既知の予定レポート。情報源と取得日を含みます	90日間、100件
get_public_price_history	保存済みの日次GPW OHLCV。情報源、日付、スケール、切り捨ての有無を含みます。オンデマンドでのデータ提供元への取得は行いません	1～3650暦日、500本
get_public_dividends	発行体の既知のWZA配当決議。1株当たり金額、通貨、日付、情報源を含みます	100件

まずは「KGHMを検索して、最新の四半期決算と報告書の情報源を表示して」と聞いてみてください。続けて、EBITDAマージンや、今後30日間に予定されているGPWレポートについて尋ねることもできます。

公開データへの直接呼び出し：

curl -sS 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/call","params":{"name":"get_quarterly_kpis","arguments":{"symbol":"KGHM","quartersBack":1}}}'

公開データへの呼び出しにはレート制限と応答サイズ制限があります。HTTP 429にはRetry-Afterが含まれます。データの網羅性は保証されません。カレンダーが空でもレポートがないことを意味するわけではなく、WZAの応答が空でも企業が配当を支払っていないことを意味するわけではありません。比率は個別の四半期報告書に基づき、行ごとに報告範囲が記載されます。TTMや株価ベースのバリュエーション倍率ではありません。財務情報の対象は発行体の報告書とGPWの発表です。ポータルのデータベースや、ポータル由来の項目は含まれません。保存済みの日次GPW株式価格履歴は公開されていますが、指数、ETF、債券は対象外です。日中データとベンダー提供の配当履歴は公開されていません。価格応答には、情報源、保存系列の更新時刻、実際のローソク足の日付が含まれます。ローソク足ごとのスケールと調整情報は保持されます。不明なスケールやnullの通貨は、メタデータが記録されていないことを示します。分割や配当の後に、調整済み履歴が変わる場合があります。対象期間がリクエストした期間より短い場合があり、切り捨ての有無は明示されます。

キーが必要な追加ツール

ポートフォリオ、アラート、予測、日中株価、その他の機能を利用するには、設定からアカウントと API キーを取得する必要があります。匿名の tools/list では、6 つの公開ツールが返されます。キーを指定した場合は、そのキーのスコープで許可されているツールが返されます。ライブカタログはサーバーレジストリから生成されます。TOOLS.mdはそのスナップショットです。

キーを指定すると、エージェントはユーザー自身の企業に関する投資仮説を保存、編集、監視することもできます。set_thesis（作成、編集、クリア）、get_my_theses（状態、状態の履歴、決算発表後の未完了レビュー）、confirm_thesis_review、および kind を指定した get_alerts の投資仮説アラートを利用できます。

HTTP では、Authorization: Bearer YOUR_KEY を追加します。stdio ブリッジでは、次を追加します。

"env": { "AGENTRYNKU_API_KEY": "YOUR_KEY" }

ブリッジは、起動時にデータを取得する呼び出しを 1 回行い、指定されたキーを検証します。この確認により、アカウントの利用枠が消費される場合があります。キーが指定されていない場合は検証しません。キーは非公開にしてください。スコープによっては、読み取りと関連する書き込みの両方が許可されることがあります。

キーなしの公開呼び出しでは、アカウントの利用枠は消費されません。キーを指定した呼び出しでは、FREE は月 100 回、PRO は月 10,000 回まで利用できます。query_companion は AI メッセージも 1 件消費します。料金とアカウントの利用状況をご覧ください。

このサーバーは注文を行ったり、証券口座に接続したりすることはありません。ソースレポートと多くのツールの説明はポーランド語です。英語のセットアップガイド、ポーランド語のガイド、方法論、課題。

ポーランド語

アカウントとキーなしでエージェントが利用できる GPW データ：企業検索、四半期決算、利益率、公開決算カレンダー、既知の WZA 配当決議、データベースの日次株価履歴。Authorization ヘッダーを付けずにクライアントを https://agentrynku.pl/api/mcp に接続するか、npx -y agentrynku-mcp を実行してください。

ポートフォリオ、アラート、予測、日中株価にはキーが必要です。キーには書き込み権限も含まれる場合があります。数値がないことはゼロを意味せず、既知の期日がないことはレポートや配当がないことを意味しません。ガイドとカタログ。

検証

このリポジトリでは、npm ci の実行後に npm run test:live を実行すると、キーなしでライブ HTTP エンドポイントと stdio ブリッジを確認できます。公開されている KGHM の決算データを読み取り、非公開の書き込みが拒否されることを確認します。開発用エンドポイントをテストするには、次を実行します：npm run test:live -- http://localhost:3104/api/mcp。

ライセンス

ブリッジのコードとドキュメントは MIT ライセンスです。サーバーが返すデータには、Agent Rynku の利用規約が適用されます。

1.2.1：元のレポートファイル

キーを指定した get_report_event の応答には、そのレポートイベントにリンクされた発行者の元の添付ファイルを示す {nazwa, url} を含む zdarzenie.zrodla[].zalaczniki が含まれます。リストが空の場合、有効な添付ファイルのリンクは記録されていません。利用可能であれば、ソースの url を情報公開ページとして使用してください。これは Agent Rynku の分析を PDF／Word 形式でエクスポートしたものではありません。このツールを使用するには、引き続き read:portfolio を含む API キーと、アカウントのスコープ内の企業が必要です。公開アクセスと通信方式に変更はありません。ツールカタログをご覧ください。

1.2.2：ファイルリンクと情報公開ページの併記

レポートに記録された情報公開ページは、添付ファイルへのリンクと必ず併記してください。直接ファイルが開かない場合、ユーザーはそのページからダウンロードできます。各添付ファイルの URL は、アンダースコアやクエリパラメーターを含めて正確にコピーしてください。Agent Rynku のウェブサイトと Telegram チャットでは、ツールの結果に含まれる元のファイル名と URL がそのまま表示されます。分析と元のファイルを組み合わせたリクエストでは、分析はそのまま保持され、ソースリンクが追加されます。このドキュメントの更新によって、MCP の応答フィールド、アクセスルール、通信方式に変更はありません。