advisorscope

advisorscope

投資助言を行う人々や企業を調べます。 advisorscope は、SEC 登録データを提供するホスト型 AdvisorFinder MCP エンドポイント向けの、キー不要の 転送クライアントです。個人の投資顧問代理人、その勤務先 企業、実際に予約できるマーケットプレイス掲載のアドバイザー、 データベース全体の統計情報を提供します。

ローカルでの設定も、アカウント作成も必要ありません。 このパッケージにはツール定義と少数のガード機能が含まれており、 すべての照会はホスト型エンドポイントに転送されます。応答は、 リモートサーバーが生成したまま、JSON テキストとして返されます。

転送の仕組み

各ツール呼び出しでは、リモート MCP サーバーとの新しいセッションを開始し、次の 3 つの手順で完了します。

1. initialize JSON-RPC POST（プロトコルバージョン 2025-03-26、クライアント advisorscope/0.1.0）を送信し、 mcp-session-id レスポンスヘッダーを取得します。
2. そのセッションヘッダーを付けて notifications/initialized POST を送信します。
3. ツール名と引数を含む tools/call POST を送信し、内容を そのまま転送します。追加、名前変更、削除は行いません。

プレーン JSON と SSE 形式の応答の両方に対応しています。 リモートの JSON-RPC エラーは、リモートのメッセージを含むエラー結果として 返されます。2xx 以外の応答では advisorfinder error: HTTP <status> が 発生し、エンドポイントに到達できない場合は advisorfinder unreachable が発生します。再試行は行いません。

設定

• API キー、アカウント、Authorization ヘッダーは一切送信されません。
• ADVISORFINDER_MCP_URL（任意）— リモート MCP エンドポイントです。デフォルトは https://mcp.advisorfinder.com/mcp です。

ツール

• search_advisors — name、firm、city、state の いずれかに一致する投資顧問代理人を検索します。各一致結果には CRD、関連する企業、4 段階の開示状況、SEC IAPD リンクが含まれます。
• get_advisor — 1 人の crd に関する全プロフィールを取得します。 勤務履歴、合格した試験、登録州、自己申告の資格、業界経験年数、 開示状況が含まれます。
• check_advisor — crd または name で登録状況をすばやく確認します。 必要に応じて firm や state で絞り込めます。活動中かどうか、 登録州、業界経験年数、開示状況を確認できます。事実情報のみを返し、 数値のリスクスコアは決して返しません。
• find_bookable_advisors — AdvisorFinder マーケットプレイスに掲載された アドバイザーを、specialty、city、state で絞り込みます。 自己提供のプロフィール情報と、その CRD に関連する規制上の情報を返します （SEC データセットにない掲載情報には、その旨を示す注記が付きます）。
• search_firms — name や state に一致する登録企業を検索します。 CRD、市区町村／州、運用資産残高の区分、アドバイザー数、 SEC IAPD リンクが含まれます。
• get_firm — 1 社の crd に関する全プロフィールを取得します。 所在地、別名および旧称、入手可能な場合は Form ADV Part 2A に記載された 手数料体系、懲戒処分フラグ、登録アドバイザー数が含まれます。
• get_database_stats — 企業とアドバイザーの総数、各上流データソースの データ時点、4 段階の開示状況の全内訳を返します。引数は不要です。

ローカルガード

送信前に、次の 2 つのチェックをローカルで実行します。

• get_advisor と get_firm には、空でない crd が必要です。 指定されていない場合は crd must be a non-empty string で失敗し、リクエストは送信されません。
• check_advisor には、crd または name のどちらかが必要です。 どちらも指定されていない場合は check_advisor requires crd or name で失敗し、リクエストは送信されません。

それ以外はすべて指定どおりに転送されます。残りの引数の検証は リモートサーバーが行います。

データの出典

ツール一覧と各ツールの意味は、上流パッケージが公開している説明に 基づいています。次の 2 点は再構成したものであり、その旨を明記しています。 ツールごとの引数セットは、表形式のスキーマではなく、説明に記載された パラメーターの意味に基づいています。また、Streamable HTTP セッションの ハンドシェイクは、ホスト型 MCP エンドポイント向けの標準的な セッションパターンに基づいています。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/advisorscope search_advisors '{"state":"CA","city":"San Francisco"}'
npx @reneturcios/advisorscope get_advisor '{"crd":"123456"}'
npx @reneturcios/advisorscope check_advisor '{"name":"Jane Doe","state":"NY"}'
npx @reneturcios/advisorscope find_bookable_advisors '{"specialty":"retirement","state":"TX"}'
npx @reneturcios/advisorscope search_firms '{"name":"Acme","state":"DE"}'
npx @reneturcios/advisorscope get_firm '{"crd":"789012"}'
npx @reneturcios/advisorscope get_database_stats '{}'
npx @reneturcios/advisorscope --version

出力はツールの結果テキストです（成功時はリモートの結果が JSON としてシリアル化されます）。終了コード：成功時は 0、エラー結果（ガード、リモート、またはトランスポートの失敗を含む）の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/advisorscope mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "advisorscope": {
      "command": "npx",
      "args": ["-y", "@reneturcios/advisorscope", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/advisorscope
docker run --rm ghcr.io/cloudcorprecords/advisorscope get_database_stats '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios