Fruit Stand Fund Returns

Fruit Stand Fund Returns — MCP サーバー

警告

2026-10-12 に提供を終了しました。 ホスト型の Fruit Stand Fund Returns MCP サーバー（https://api.fruitstand.dev/mcp） は停止され、MCP レジストリから削除されました。以下の手順は現在機能しません。この リポジトリは参考用としてのみアーカイブされています。 Fund Returns データセットは引き続き Snowflake Marketplace で利用できます。fruitstand.dev/datasets/fund-returnsをご覧ください。

32,000 以上の米国の投資信託および ETF の直近期間と暦年のトータルリターンを、MCP サーバーとして提供します。 AI アシスタントにティッカー別のファンドパフォーマンスを比較させられます。Morningstar や Bloomberg との契約は不要で、無料プランがあり、REST API と同じ API キーを使えます。

Streamable HTTP を使用するホスト型のリモート MCP · Claude、Cursor、およびあらゆる MCP クライアントで動作 · 無料の API キーを取得

---

クイックスタート

1. API キーを取得する

app.fruitstand.dev で登録してください。無料プランではカード情報は不要です。

2. クライアントをエンドポイントに接続する

https://api.fruitstand.dev/mcp

Streamable HTTP を使用するリモート MCP です。API キーをベアラートークンとして認証します。

ネイティブのリモート MCP クライアント（Claude web／desktop の「カスタムコネクターを追加」、Cursor など）では、上記の URL を使用して、次のヘッダーを追加してください。

Authorization: Bearer YOUR_API_KEY

Claude Desktop の設定（claude_desktop_config.json）では、mcp-remote を使ってリモートエンドポイントにブリッジ接続します。

{
  "mcpServers": {
    "fruit-stand": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.fruitstand.dev/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

クライアントを再起動すると、Fruit Stand のツールが表示されます。

Docker — docker コマンドを使うクライアント向けの、同じブリッジをコンテナーとして実行する方法です（このリポジトリの Dockerfile）。

{
  "mcpServers": {
    "fruit-stand": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "FRUITSTAND_API_KEY", "ghcr.io/fruitstanddev/fruitstand-mcp"],
      "env": { "FRUITSTAND_API_KEY": "YOUR_API_KEY" }
    }
  }
}

コンテナーは stdio と api.fruitstand.dev/mcp の間をブリッジするだけです。すべてのデータはホスト型サーバーから取得されます。

3. 質問する

「SPY、QQQ、VTI の 1 年、5 年、設定来のリターンを比較し、2022 年の暦年で最も成績が良かったものを教えてください。」

アシスタントは batchTrailingReturns と batchCalendarReturns を呼び出して、結果を要約します。

---

ツール

REST API と同じ 6 つのツールです。リターンは小数で返されます（0.1234 = 12.34%）。

ツール	機能	主な入力
searchFunds	ファンド一覧の検索／表示（キーセット方式のページネーション）	q、type、country、exchange、cursor、limit
getFund	ティッカーによるファンドのメタデータ取得	code
getTrailingReturns	1 つのファンドの直近期間リターンを取得（最新または指定日時点）	code、as_of?
batchTrailingReturns	1 回の呼び出しで最大 100 ファンドの直近期間リターンを取得	codes[]、as_of?
getCalendarReturns	1 つのファンドの暦年リターンを取得（最新または指定年）	code、year?
batchCalendarReturns	1 回の呼び出しで最大 100 ファンドの暦年リターンを取得	codes[]、year?

ティッカーには SYMBOL.US 形式を使います（例：SPY.US、VTSAX.US）。

---

データについて

• 対象範囲： 米国の投資信託および ETF 約 32,000 件。
• 直近期間リターン： 設定来までの標準期間を網羅したトータルリターン（分配金を再投資）。
• 暦年リターン： 暦年ごとの年間トータルリターン。
• 更新頻度： Snowflake Marketplace の Fruit Stand データセットを構築するものと同じパイプラインから毎日更新。
• 算出方法とフィールドのリファレンス： app.fruitstand.dev/api/mcp およびドキュメント。

MCP ツールの呼び出しは REST の呼び出しと同じように計量され、月間クォータに加算されます。有効なプランがないキーでツールを呼び出すと、403 が返されます。

---

リンク

• キーの取得／料金： https://app.fruitstand.dev/pricing
• MCP のセットアップドキュメント： https://app.fruitstand.dev/api/mcp
• REST API リファレンス： https://app.fruitstand.dev/api
• マーケティングサイト： https://fruitstand.dev
• データパイプライン／データセットのステータス： https://fruitstand.dev/datasets

ライセンス

MIT — このリポジトリには、ホステッドサービスの公開ドキュメントとコネクターのメタデータが含まれています。サービスの実装は別のリポジトリにあります。