stockportfolio-mcp

stockportfolio-mcp

エージェント向けの、SEC提出書類に基づく米国株データ — 財務情報、SEC提出書類の時系列、企業比較、ファンドのプロフィールを提供します。返されるすべての値には、その出典となる提出書類のURLが付いています。データがない場合はそのまま欠落として返し、推定は行いません。

# Get a key (Dev plan: $19.99/month, 200 credits) → https://stockportfolio.pro/api

インストール

MCP クライアントの設定に以下を追加して、再起動してください。

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "stockportfolio": {
      "command": "npx",
      "args": ["-y", "stockportfolio-mcp"],
      "env": { "STOCKPORTFOLIO_API_KEY": "your-key-here" }
    }
  }
}

Cursor — ~/.cursor/mcp.json。同じブロックを使用してください。

その後、エージェントに 「NVDA で sp_financials を使い、各数値の対象期間と提出書類の出典を表示してください。」 のように尋ねてください。

Node 18 以降が必要です。初回実行時に npx がパッケージを取得します。それ以外のインストールは不要です。このパッケージには必要なものがすべて含まれています。

ツール

ツール	返される内容	クレジット
sp_financials(ticker, tool?)	提出済み財務諸表から取得した、期間が固定された数値です。tool で表示内容を選択します。earnings-quality（デフォルト）、dilution、buybacks-vs-dilution、revenue-consistency、profitability-trend、cash-flow-quality、free-cash-flow-trend、debt-snapshot などがあります。	1 クレジット
sp_filing(ticker)	直近の 10-K／10-Q／8-K／Form 4 を、日付と EDGAR への直接リンクとともに返します。	1 クレジット
sp_compare(tickers)	2 つのティッカーを横並びで比較します。最新の提出済み年次報告書に基づきます。対象期間は別々に保たれます。	1 クレジット
sp_screen(tickers)	提出済みの売上高成長率に基づいて、最大 10 銘柄を順位付けします。	1 クレジット
sp_fund(symbol)	ETF／投資信託の費用、保有銘柄、資産配分、パフォーマンス、リスクを返します。ファンドデータであることを明示し、企業の SEC データとして提示することはありません。	1 クレジット
sp_ask(question)	提出書類に基づく回答と、そのソース区分（filed／fund-data／live-web）を返します。	4 クレジット
sp_health()	稼働状態の確認：バージョン、ツール数。無料です。	0

クレジットはキーに設定された月間利用枠（Dev プランでは月 200 クレジット）で、毎月 1 日にリセットされます。 キーが間違っている場合や利用枠を使い切った場合でも sp_health は応答するため、利用枠を使い切ったキーと停止中のサービスを確認できます。

応答例

実際の応答を簡略化したものです。これは sp_filing("NVDA") の例です。

{
  "tool": "filing-timeline",
  "symbol": "NVDA",
  "generatedAt": "2026-09-11T18:39:50.366Z",
  "data": {
    "tool": "filing-timeline",
    "symbol": "NVDA",
    "source": "SEC EDGAR",
    "filings": [
      {
        "form": "4",
        "label": "Form 4 (insider ownership)",
        "date": "2026-09-08",
        "url": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml"
      }
    ]
  },
  "source": {
    "type": "filed",
    "url": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml",
    "period": null,
    "note": "Informational research only — verify in the linked SEC filing. Not investment advice."
  },
  "warnings": [],
  "citation": {
    "filingSource": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml",
    "verifyAt": "https://www.stockportfolio.pro/stocks/NVDA?utm_source=mcp&utm_medium=integration&utm_campaign=stockportfolio-mcp",
    "poweredBy": "StockPortfolio.pro — filing-grounded US company data"
  }
}

source.url がこの仕組みの要点です。エージェントは数値を断定する代わりに、提出書類を引用できます。フィールドに提出書類の URL がない場合は、黙って省略せず、その旨を応答に記載します。また、提出書類が不完全な場合は warnings で通知します。

このパッケージについて

ホスト型エンドポイント https://www.stockportfolio.pro/mcp に中継する stdio MCP サーバーです。stdin で JSON-RPC を読み取り、キーを Bearer ヘッダーとして各リクエストを転送し、応答を stdout に中継します。提出書類のデータ、モデルのコード、サーバーのロジックは tarball に含まれていません。このパッケージが保持するのは指定されたキーのみで、そのキーを送信するのはこのエンドポイントだけです。

エンドポイントはステートレスなため、クライアントごとにブリッジを 1 つ起動すれば問題ありません。再開するセッションはなく、接続が切れても次の呼び出し時に再構築されます。

トラブルシューティング

症状	原因
The API key was rejected	STOCKPORTFOLIO_API_KEY が設定されていない、取り消されている、または引用符付きで貼り付けられています。
Out of credits for this month	月間利用枠を使い切っています。利用枠は毎月 1 日にリセットされます。または、料金ページでクレジットを追加してください。
Rate limited	同時呼び出しが多すぎます。少し待ってから再試行してください。
npx can't find the package	Node 18 以降が必要です。ターミナルで npx -y stockportfolio-mcp を実行すると、クライアントに表示されるものと同じエラーを確認できます。
クライアントにツールが表示されない	設定を編集した後、クライアントを再起動してください。MCP の設定は起動時に読み込まれます。

ブリッジはエラーを stderr に出力します。ほとんどの MCP クライアントではログ欄に表示されます。直接確認するには、ブリッジを自分で実行してください。

STOCKPORTFOLIO_API_KEY=your-key npx -y stockportfolio-mcp

リンク

• 料金とキー管理：https://stockportfolio.pro/api?utm_source=npm&utm_medium=integration&utm_campaign=stockportfolio-mcp
• REST API（同じデータをHTTPで提供）：https://stockportfolio.pro/api/v1
• ソースと対象範囲：https://www.stockportfolio.pro/

情報提供を目的とした調査のみを対象としています。投資助言ではありません。ファンドデータはYahoo由来であり、再配布できません。