Stock Trends Market Intelligence

Stock Trends MCP サーバー

Stock Trends Model Context Protocol（MCP）サーバーです。稼働中の公開リモート MCP と、別途利用可能なローカル stdio クライアントに対応します。

アーキテクチャ上の境界（このサーバーの役割）

このリポジトリは、フロントエンドの Stock Trends API を介する薄い MCP アダプターです。稼働中の公開リモート MCP を提供し、ローカル stdio に対応します。独自の分析判断を行う機能はありません。

公開リモート MCP

リモート MCP クライアントを Streamable HTTP エンドポイントに接続します。

https://mcp.stocktrends.com/mcp

開発者向けの接続ガイドは、developer.stocktrends.com/mcp で確認できます。デプロイ済みのリモート機能では、ツールが正確に 19 個、公開リソースが 10 個、プロンプトが 0 個公開されています。接続と機能の検出に Stock Trends サブスクリプション API キーは必要ありません。無料のツールは stocktrends_estimate_workflow_cost、stocktrends_lookup_instruments、stocktrends_resolve_instrument の 3 個です。x402 V2 対応の有料ツールは 16 個あります。GET ツールは stocktrends_get_stim_latest、stocktrends_get_stim_history、stocktrends_get_indicators_latest、stocktrends_get_indicators_history、stocktrends_get_selections_latest、stocktrends_get_market_regime_latest、stocktrends_get_market_regime_history、stocktrends_get_breadth_sector_latest、stocktrends_get_leadership_summary_latest、stocktrends_get_screener_top、stocktrends_get_market_epoch_latest、stocktrends_get_market_epoch_history の 12 個です。POST ツールは stocktrends_evaluate_symbol（POST /v1/decision/evaluate-symbol）、stocktrends_construct_portfolio（POST /v1/portfolio/construct）、stocktrends_evaluate_portfolio（POST /v1/portfolio/evaluate）、stocktrends_compare_portfolios（POST /v1/portfolio/compare）の 4 個です。stocktrends_get_selections_latest が返すのは基本の選択ユニバースであり、別途しきい値が適用された公開済み ST-IM Select リストではありません。

有料のリモートツールでは、支払いに対応した MCP クライアントが支払いを取得し、承認します。クライアントはその承認を MCP リクエストメタデータの x402/payment として渡し、アダプターは上流の Stock Trends API に PAYMENT-SIGNATURE ヘッダーとして転送します。決済が確認されると、決済メタデータが x402/payment-response として返されます。これらの MCP メタデータフィールドは API ヘッダーとは別のものです。このサーバーは、購入者のウォレットを制御したり、秘密鍵を保持したり、支払い承認に署名したり、支払いを開始したり、Stock Trends のインテリジェンスを再計算したり、証券取引を実行したりしません。接続するだけでクライアントが支払い機能を得るわけではありません。また、x402 に準拠した REST 購入者が、この MCP 固有のやり取りに自動的に対応するわけでもありません。支払い結果が不確かな場合は自動で再試行しないでください。POST ツールでは、分析上の HTTP エラーが返された場合でも支払いが決済済みであることがあります。また、保留中のチャレンジ状態はアダプターの正規リクエスト本文に紐づいており、その本文に独立した暗号署名を行うものではありません。

ローカルの stdio と Streamable HTTP の設定

ローカルで使用するには Node.js 20+ が必要です。ローカルプロセスの起動では、引き続きローカル stdio がデフォルトのトランスポートであり、完全にサポートされています。ソースでは STOCKTRENDS_MCP_TRANSPORT=streamable-http を明示的に指定することもでき、その場合は /mcp で MCP を提供し、/healthz と /readyz で稼働状況を確認できます。ローカルリスナーはデフォルトで 127.0.0.1:3000 にバインドします。上記のデプロイ済みパブリックエンドポイントは、このローカル設定とは別のものです。公式 MCP Registry のバージョン 1.0.2 は公開済みで、アクティブかつ最新であり、ローカルの stdio npm パッケージと、Streamable HTTP を使用するリモート MCP エンドポイント https://mcp.stocktrends.com/mcp の両方を案内しています。

デフォルトでは、ローカルで起動する streamable-http 設定は認証情報不要です。10 個のパブリックリソース、上記の 3 つの無料ツール、プロンプトなしで利用できます。設定済みの API キー、有料ツール／実行設定、または個別のローカル x402 リレー／チャレンジ／ライブ／プルーフ転送設定がある場合は、起動を拒否します。STOCKTRENDS_ENABLE_REMOTE_X402_STIM=true は、本番形式のリモート x402 登録を有効にする、Streamable HTTP 専用の個別設定です。API キーによる有料モードやローカルのチャレンジリレーを有効にせず、3 つの無料ツールと 16 個の x402 有料ツール（合計 19 個）を公開します。このソースレベルの設定はデプロイ済みのパブリックサービスとは別のものであり、デプロイ手順を示すものではありません。ローカル stdio では、サブスクリプション／API キーによる有料 REST 呼び出しを別途ゲート付きで引き続き利用できます。オプションの x402 モードはデフォルトで無効であり、チャレンジメタデータの確認／リレーのみを行います。支払いは行わず、支払いプルーフや支払いヘッダーの転送、有料 API データの返却、支出も行いません。MPP は実装されていません。

権限の流れは一方向のみです。

Stock Trends dataset
  -> Stock Trends API
  -> published Stock Trends API responses/artifacts
  -> MCP adapter (this repository)
  -> external MCP clients/agents

MCP アダプターは、以下のことを行いません。

• Stock Trends のデータ、ST-IM、インジケーターを再計算しません。
• Stock Trends のデータベースやコントロールプレーンに直接アクセスしません。
• 投資に関するアドバイス、調査、取引ガイダンスを生成しません。
• レビュー済みの公開済み Stock Trends API レスポンスを MCP のリソースおよびツールのレスポンスに変換するだけです。

以下で説明するパブリックリソースとデフォルト／無料モードは、認証情報不要です。インストール、確認、利用に API キー、サブスクリプション、支払い認証情報は必要ありません。条件付きの有料 ST-IM 実行パスは別個の明示的なゲート付き機能であり、デフォルトでは無効です（条件付き有料 ST-IM ツールを参照）。さらに、デフォルトで無効の x402 設定により、同じ有料セマンティックツール名を公開できます。リレーとチャレンジのフラグを使用した場合、ローカルのモック専用動作が維持されます。これとは別の 3 つ目のライブフラグを有効にすると、キー不要のチャレンジを 1 回だけ実行する上限付きパスが有効になる場合があります。どちらの x402 モードも、プルーフを受け付けたり転送したりせず、支払いヘッダーの送信、有料データの返却、支払い、支出も行いません。

初めての方へ。 パブリックリモート MCP を利用する場合は、上記のエンドポイントと Developer Portal を使用してください。ローカルサーバーを実行する場合は、デフォルト／無料モードのクイックスタートから始め、続いてローカル stdio MCP クライアントを接続するをご覧ください。有料変数を設定する前に、有料モードの設定とセキュリティモデルをお読みください。

デフォルト／無料モードのクイックスタート

サーバーをインストールまたは確認する際は、まずこの方法をおすすめします。デフォルトモードでは、サーバーは次のように動作します。

• API キーは必要ありません。
• 有料の実行は行わず、支出も発生しません。
• 3 つの無料 MCP ツール、stocktrends_estimate_workflow_cost、stocktrends_lookup_instruments、stocktrends_resolve_instrument を公開します。
• すべてのパブリックリソースを認証情報なしで利用できます。
• MCP プロンプトを登録しません。

セットアップ

既存のプロジェクトスクリプトのみを使用する場合：

git clone <repository-url>
cd stocktrends-mcp-server
npm install
npm run build

この git clone + npm install + npm run build の手順に続いて、コンパイル済みの dist/server.js をローカルで stdio 実行する方法は、引き続き完全にサポートされており、このリポジトリの主要なインストール方法です。このパッケージは @stocktrends-publications/stocktrends-mcp-server として npm レジストリからも公開されています。すぐ下の公開 npm インストールを参照してください。さらに、3つ目の別のインストール方法として、ローカルでビルドした npm パッケージ成果物（レジストリからのインストールではなく、ローカルの .tgz）も、クロスプラットフォームで検証済みです。以下のローカルパッケージ成果物からのインストール（自分でビルドする代替方法）と、クロスプラットフォームのパッケージインストール／stdio 検証レポートを参照してください。

この方法では、環境変数も .env ファイルも必要ありません。デフォルト／無料モードのテスト中は、STOCKTRENDS_ENABLE_PAID_TOOLS、STOCKTRENDS_API_KEY、STOCKTRENDS_ENABLE_PAID_EXECUTION を設定しないでください。

任意：npm start を実行するとローカルの stdio サーバープロセスが直接起動します。これは主に手動のスモークテストに便利です（stdin で JSON-RPC 入力を待機します）。以下の MCP Inspector からサーバーを起動する前に、Ctrl+C で停止してください。

公開 npm インストール

このパッケージは @stocktrends-publications/stocktrends-mcp-server として npm レジストリに一般公開されています。誰でも認証情報なしで、このリポジトリをクローンせずに名前を指定してインストールできます：

npm install @stocktrends-publications/stocktrends-mcp-server

特定のリリースに固定して再現可能なインストールを行うには、上記のコマンドに @<version>（例：@1.0.0）を追加してください。バージョンを省略すると、公開されている最新リリースがインストールされます。インストール後、このパッケージは npm が管理するコマンドシム（チェックアウト相対の dist/server.js パスではありません）を提供します。パッケージをインストールした場合のシムと、チェックアウト相対パスの両方の設定例については、以下のローカル stdio MCP クライアントを接続するを参照してください。

1.0.0 リリースは、公開前に凍結されオフラインで検証済みのリリース候補成果物とバイト単位（SHA-256）で一致することが確認されています。また、名前を指定した匿名インストールと、公開済みパッケージに対する Windows 上の MCP initialize／リストのみのハンドシェイクも検証済みです（docs/SECURITY_MODEL.md §18およびMCP レジストリ対応の実装メモを参照してください）。公開済みの npm 1.0.1 成果物も、同様に過去の無料ツール1つのリリースです。この公開済みパッケージの結果は、現在のソースチェックアウトにおける無料ツール3つの構成を表すものではありません。com.stocktrends/market-intelligence の公式 MCP レジストリバージョン 1.0.2 は、公開済みで、アクティブかつ最新です。このバージョンは、既存の npm 1.0.1 ローカル stdio パッケージと、Streamable HTTP を使用するリモート MCP エンドポイント https://mcp.stocktrends.com/mcp を告知しています。レジストリのメタデータバージョンと npm パッケージのバージョンは、意図的に異なっています。

ローカルパッケージ成果物のインストール（自分でビルドする代替方法）

上記の公開 npm インストールに加えて、このリポジトリのパッケージはローカルでビルドして、インストール可能な npm 成果物としてパッケージ化することもできます。Windows および WSL2 Ubuntu で利用できます（クロスプラットフォームのパッケージインストール／stdio 検証レポートを参照）。この方法は、未公開のローカルビルドを公開済みパッケージと同じ識別情報でテストする場合に便利ですが、通常のインストールには必要ありません。

• 成果物はこのリポジトリには保持されません。.tgz はコミットされず、チェックアウトにも含まれません。
• package.json には、公開 npm パッケージと同じ公開上の識別情報が記載されています。スコープ付きの名前 @stocktrends-publications/stocktrends-mcp-server、MCP Registry の識別情報 mcpName com.stocktrends/market-intelligence、および明示的な公開用 publishConfig（access: public、公開 npm レジストリ）です。パッケージ公開設定の実装メモおよびMCP Registry 対応状況の実装メモを参照してください。
• この方法を利用するには、レビュー済みのチェックアウトから自分で成果物をビルドしてください。

チェックアウトからローカル成果物を自分でビルドするには、次のようにします。

git clone <repository-url>
cd stocktrends-mcp-server
npm install
npm run build
npm pack

これにより、現在のディレクトリに stocktrends-publications-stocktrends-mcp-server-1.0.1.tgz が生成されます。レビュー済みのクローズド成果物許可リストは dist/**/*.js、dist/**/*.d.ts、README.md、LICENSE です（パッケージメタデータとクローズド成果物許可リストの実装を参照）。これを別のコンシューマープロジェクト（このチェックアウトではありません）にインストールします。

npm install <path-to-local-stocktrends-publications-stocktrends-mcp-server-1.0.1.tgz>

このローカル成果物の方法と、上記の公開 npm インストールの方法では、異なる 2 つの経路を通じて同じレビュー済みパッケージ識別情報をインストールします。未公開のローカルビルドをテストする必要がある場合を除き、公開 npm インストールをおすすめします。

インストール後、パッケージはチェックアウト相対の dist/server.js パスではなく、npm が管理するコマンドシムを提供します。POSIX システム（Linux、macOS、WSL）では node_modules/.bin/stocktrends-mcp-server にシンボリックリンクが作成され、Windows では node_modules\.bin\stocktrends-mcp-server.cmd に生成されたシムが作成されます。bin がグローバルにインストールされているとは想定しないでください。コンシューマープロジェクト自身の node_modules/.bin から解決してください。チェックアウトを使った例と併せて、パッケージをインストールしたクライアントの設定例については、以下のローカル stdio MCP クライアントを接続するを参照してください。

MCP Inspector で検証する（API キー不要）

ビルド後（npm run build）、有料モードの環境変数を設定せずに、コンパイル済みの stdio サーバーを MCP Inspector に指定します。

npx @modelcontextprotocol/inspector node dist/server.js

Inspector の UI で、次の点を確認します。

• ツール一覧には、無料ツールの stocktrends_estimate_workflow_cost、stocktrends_lookup_instruments、stocktrends_resolve_instrument の3つだけが表示されます。ローカルのサブスクリプション／API キーが必要な有料ツール9つ（stocktrends_get_stim_latest、stocktrends_get_stim_history、stocktrends_get_indicators_latest、stocktrends_get_indicators_history、stocktrends_get_selections_latest、stocktrends_get_market_regime_latest、stocktrends_get_market_regime_history、stocktrends_get_breadth_sector_latest、stocktrends_get_leadership_summary_latest）は表示されません。
• クライアントにプロンプトパネルがある場合、プロンプト一覧が空であることを確認します。
• 公開リソース（例：stocktrends://api/openapi、stocktrends://ai/context）が一覧に表示され、認証情報を設定しなくても読み取り可能であることを確認します。

この確認では、有料の実行を必要としたり、実行したりすることなく、無料／デフォルトの境界を検証できます。

Inspector の詳細な手順（デフォルト／無料の一覧、有料ツールを公開した一覧と実行を伴わない確認、ロールバックのチェックリスト）については、Phase 5A MCP Inspector Validation Runbook を参照してください（有料ツールを公開した場合の構成とリソース数は、Phase 4 当時の3ツール構成に基づいて記述された時点では正確でした。現在の数はこの README に記載しています）。

シークレットの安全な取り扱い（無料モード）

無料／デフォルトモードでは API キーは不要なため、このクイックスタートではシークレットを扱いません。デフォルトモードは、必ずキーなしでテストし、デモしてください。認証情報の取り扱いに関する規則（プレースホルダーのみを使い、実際のキーを絶対にコミットしたり貼り付けたりしないこと）については、トップレベルのシークレットの安全な取り扱いセクションにまとめています。

ローカルの stdio MCP クライアントに接続する

このセクションでは、ローカルの stdio 経由でサーバーを MCP クライアントに接続します。以下の各サブセクションでは、2種類のインストール方法を明確に分けて説明します。

• リポジトリをチェックアウトする方法（先に npm run build でビルド）：コンパイル済みのエントリーポイントを直接起動するために、command: "node" と args: ["<absolute-path-to-checkout>/dist/server.js"] を指定します。ここで <absolute-path-to-checkout> は、使用するマシン上にあるこのリポジトリの絶対パスです。
• ローカルパッケージ成果物を使う方法（上記のローカルパッケージ成果物のインストールを参照）：<path-to-consumer-project> から解決される、npm でインストールしたコマンドシムを起動します。<path-to-consumer-project> は、npm install <path-to-local-...-1.0.1.tgz>（または npm install @stocktrends-publications/stocktrends-mcp-server。詳しくは公開 npm からのインストールを参照）を実行した別のプロジェクトの絶対パスです。このリポジトリのチェックアウト先でも、グローバルインストール先でもありません。

このセクションの主な例はすべて無料モードです。STOCKTRENDS_* 変数は設定せず、API キーも設定しないため、費用が発生することはありません。クライアント設定ファイルに有料モード用の変数を追加する前に、シークレットの安全な取り扱いをお読みください。

A. Claude Desktop

フリーモードの mcpServers エントリー（env ブロックなし。デフォルトで認証情報は不要です）：

{
  "mcpServers": {
    "stocktrends": {
      "command": "node",
      "args": ["<absolute-path-to-checkout>/dist/server.js"]
    }
  }
}

Windows の JSON パスでは、二重バックスラッシュ（"C:\\Users\\you\\stocktrends-mcp-server\\dist\\server.js"）またはスラッシュ（"C:/Users/you/stocktrends-mcp-server/dist/server.js"）を使用する必要があります。バックスラッシュを 1 つだけ使用すると、有効な JSON になりません。

Claude Desktop の設定ファイルの場所は、クライアントのバージョンによって異なります。執筆時点では、次のとおりです。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

クライアントのバージョンによってファイルの場所やスキーマが変わることがあるため、これらのパスを使用する前に、インストール済みの Claude Desktop の最新ドキュメントで確認してください。

パッケージインストール版（ローカルアーティファクトのパス、フリーモード）。 チェックアウト相対パスの代わりに、npm でインストールされたコマンドシムを使用します。

{
  "mcpServers": {
    "stocktrends": {
      "command": "<path-to-consumer-project>/node_modules/.bin/stocktrends-mcp-server"
    }
  }
}

Windows の場合（生成される .cmd シム）：

{
  "mcpServers": {
    "stocktrends": {
      "command": "<path-to-consumer-project>\\node_modules\\.bin\\stocktrends-mcp-server.cmd"
    }
  }
}

<path-to-consumer-project> は、npm install <path-to-local-stocktrends-publications-stocktrends-mcp-server-1.0.1.tgz>（または npm install @stocktrends-publications/stocktrends-mcp-server）を実行した別のプロジェクトの絶対パスです。このリポジトリのチェックアウト先や、グローバルインストール先は指定しないでください。

有料機能を任意で公開する場合（公開のみ。実行はしません）。 クライアントのツールリストに有料ツールの定義を追加します。有料 API 呼び出しを許可したり、実行したりするものではありません。

{
  "mcpServers": {
    "stocktrends": {
      "command": "node",
      "args": ["<absolute-path-to-checkout>/dist/server.js"],
      "env": {
        "STOCKTRENDS_ENABLE_PAID_TOOLS": "true",
        "STOCKTRENDS_API_KEY": "<your-api-key>"
      }
    }
  }
}

公開（STOCKTRENDS_ENABLE_PAID_TOOLS とキー）と実行（別個の STOCKTRENDS_ENABLE_PAID_EXECUTION フラグに加え、必須の料金事前確認、ゼロ以外の上限、上限をカバーする予算。詳しくは有料モードの設定を参照）は、別々の 2 つのゲートです。この設定では実行を有効にしないため、公開だけでリクエストが送信されたり、費用が発生したりすることはありません。有料実行の適格性チェックリストについては、フェーズ 5A オペレーター安全性・リリースチェックリストの §4 を参照してください。これは実際の実行手順書ではありません。

設定ファイルに保存される認証情報に関する警告。 Claude Desktop の設定ファイルは平文で保存され、再起動後もディスクに残ります。オペレーターの監督下で意図的に使用するセッションのために実際の API キーをここに設定した場合は、使用後すぐに削除し、上記のフリーモード設定に戻してください。実際のキーをクライアントの設定ファイルに残さないでください。

B. Claude Code

境界に関する注意： Claude Code はエージェント型クライアントであり、フェーズ 5D の承認はエージェントによる自律的な有料実行には適用されません。そのため、Claude Code でドキュメント化されている手順は、認証情報不要で費用が発生しない 3 つのツールすべてを使用するフリーモードのみです。有料機能の公開・実行は、有料モードの設定および上記の適格性チェックリストに従う、オペレーターのシェルからオペレーターの監督下で行う別個の手順です。Claude Code 用の手順は意図的に記載していません。

Claude Code CLI を使ってサーバーをローカルに登録します。

claude mcp add --transport stdio stocktrends -- node <absolute-path-to-checkout>/dist/server.js

これは env エントリーのないフリーモードの stdio サーバーを登録します。同様に、プロジェクトスコープの .mcp.json エントリーも同じ形式です（command と args があり、type／url フィールドがないエントリーは、stdio サーバーとして読み込まれます）。

{
  "mcpServers": {
    "stocktrends": {
      "command": "node",
      "args": ["<absolute-path-to-checkout>/dist/server.js"]
    }
  }
}

パッケージインストール版（ローカルアーティファクトのパス、フリーモード、POSIX）：

claude mcp add --transport stdio stocktrends -- <path-to-consumer-project>/node_modules/.bin/stocktrends-mcp-server

パッケージインストール版（ローカルアーティファクトのパス、フリーモード、Windows）：

claude mcp add --transport stdio stocktrends -- <path-to-consumer-project>\node_modules\.bin\stocktrends-mcp-server.cmd

<path-to-consumer-project> は、npm install <path-to-local-stocktrends-publications-stocktrends-mcp-server-1.0.1.tgz>（または npm install @stocktrends-publications/stocktrends-mcp-server）を実行した別のプロジェクトの絶対パスです。このリポジトリのチェックアウト先や、グローバルインストール先は指定しないでください。

C. 汎用 MCP stdio クライアント

ローカルの stdio サーバーをサポートする任意の MCP クライアントで、クライアントに依存しない次の形式を使用できます。

{
  "command": "node",
  "args": ["<absolute-path-to-checkout>/dist/server.js"],
  "env": {}
}

パッケージインストール版（ローカルアーティファクトのパス、無料モード）。 POSIX：

{
  "command": "<path-to-consumer-project>/node_modules/.bin/stocktrends-mcp-server",
  "env": {}
}

Windows（生成された .cmd shim）：

{
  "command": "<path-to-consumer-project>\\node_modules\\.bin\\stocktrends-mcp-server.cmd",
  "env": {}
}

<path-to-consumer-project> は、npm install <path-to-local-stocktrends-publications-stocktrends-mcp-server-1.0.1.tgz>（または npm install @stocktrends-publications/stocktrends-mcp-server）を実行した別プロジェクトの絶対パスです。このリポジトリのチェックアウト先や、グローバルインストールのパスは指定しないでください。

任意の有料公開版（上記の Claude Desktop と同じルールです。公開のみで、実行フラグはありません）：

{
  "command": "node",
  "args": ["<absolute-path-to-checkout>/dist/server.js"],
  "env": {
    "STOCKTRENDS_ENABLE_PAID_TOOLS": "true",
    "STOCKTRENDS_API_KEY": "<your-api-key>"
  }
}

公開は実行ではありません。STOCKTRENDS_ENABLE_PAID_EXECUTION が追加で true に設定され、必須の料金事前チェック、ゼロ以外のローカル上限、および適用対象となる予算上限のすべてを満たすまで、リクエストは送信されず、費用も発生しません（有料モードの設定を参照）。ここでは、有料実行を気軽に実行するための手順として説明していません。コピペ用のレシピではなく、適格性を確認するためのチェックリストとして扱ってください。

D. 診断用リファレンスとしての MCP Inspector

MCP Inspector は、引き続きサーバーのツール、リソース、プロンプトの構成を確認するための便利な診断・運用ツールです。上記の MCP Inspector で検査するを参照してください。ただし、唯一のインストール方法でも、主要なインストール方法でもありません。日常的な使用では、上記 A～C のクライアントのいずれかに接続してください。Phase 5A MCP Inspector 検証手順書には、より詳細な Inspector の手順が記載されています。有料公開の構成とリソース数は、Phase 4 時代の 3 ツール構成を対象に執筆された時点では正しく、当時の記録として今も正確ですが、現在の数はこの README に記載されています。

有料モードの設定

有料ツールはデフォルトで無効です。デフォルト／無料モードでサーバーをインストール、検査、使用するために、このセクションの設定は必要ありません。このセクションでは、有料の ST-IM ツールを公開する方法と、有料の実行を制御する方法をそれぞれ説明します。有料の変数を設定する前にお読みください。有料モードの方針は、docs/SECURITY_MODEL.md および docs/PHASE5A_OPERATIONAL_HARDENING_DESIGN_MEMO.md に定められています。

有料ツールの公開と有料実行は、別々の 2 つのゲートで制御されます。 公開を有効にしても、それだけで有料の呼び出しが実行されることはありません。

有料フラグの解析は厳密です： リテラル文字列 true のみが STOCKTRENDS_ENABLE_PAID_TOOLS または STOCKTRENDS_ENABLE_PAID_EXECUTION を有効にします。値が false、0、no、off の場合は無効になります。1、yes、on などのその他の値では、invalid_config により起動に失敗します。実行フラグの名前は STOCKTRENDS_ENABLE_PAID_EXECUTION です。STOCKTRENDS_ALLOW_PAID_EXECUTION は認識されない変数であり、設定しても何も起こりません。

有料ツールの公開には、次の両方が必要です：

• STOCKTRENDS_ENABLE_PAID_TOOLS=true
• STOCKTRENDS_API_KEY が設定されていること

両方が設定されている場合、サーバーはさらに、ペアとなる有料 ST-IM ツール定義 2 つ、ペアとなる有料インジケーターのツール定義 2 つ、ベースセレクションのツール定義 1 つ、およびマーケットコンテキストのツール定義 4 つを登録するため、公開されるツールは合計でちょうど 12 個になります：

• stocktrends_estimate_workflow_cost — 認証情報不要の計画ツール（常に利用可能）
• stocktrends_lookup_instruments — 認証情報不要の銘柄検索ツール（常に利用可能）
• stocktrends_resolve_instrument — 認証情報不要の銘柄解決ツール（常に利用可能）
• stocktrends_get_stim_latest — 有料 ST-IM ツール定義
• stocktrends_get_stim_history — 有料 ST-IM ツール定義
• stocktrends_get_indicators_latest — 有料インジケーターツール定義
• stocktrends_get_indicators_history — 有料インジケーターツール定義
• stocktrends_get_selections_latest — 有料の基本 ST-IM 選定ユニバースツール定義
• stocktrends_get_market_regime_latest — 有料の市場コンテキストツール定義（レジーム）
• stocktrends_get_market_regime_history — 有料の市場コンテキストツール定義（レジーム）
• stocktrends_get_breadth_sector_latest — 有料の市場コンテキストツール定義（広がり）
• stocktrends_get_leadership_summary_latest — 有料の市場コンテキストツール定義（リーダーシップ）

公開範囲を変更しても、3 つの無料ツールは変わらず、API キーも送信されません。公開範囲の変更によって MCP クライアントに表示されるのは、9 つの有料ツール定義のみです。有料インジケーターが内部で使用する銘柄解決機能は、認証情報不要のヘルパーです。これは、別途登録されている公開ツール stocktrends_lookup_instruments および stocktrends_resolve_instrument とは別のものです。そのため、デフォルト／無料の公開範囲は 3 つのツールのままです。

有料実行には、さらに次のすべてが必要です。

• STOCKTRENDS_ENABLE_PAID_EXECUTION=true — 公開範囲フラグとは別の実行時フラグです。
• 必須の料金事前チェックが解決済みであること（STOCKTRENDS_REQUIRE_PRICING_PREFLIGHT は true のままです）。
• 明示的なゼロ以外のローカル上限（STOCKTRENDS_MAX_PAID_CALLS_PER_SESSION および STOCKTRENDS_MAX_PAID_CALLS_PER_TOOL）。
• ゼロ以外のコストをカバーする予算上限（STOCKTRENDS_MAX_STC_PER_SESSION と、USD コストが適用される場合は STOCKTRENDS_MAX_USD_PER_SESSION）。

実行を有効にすると、ツール数ではなく呼び出しの動作が変わります。実行が有効で、すべての条件を満たしている場合、有料の ST-IM、インジケーター、選定、または市場コンテキストツールを呼び出すと、承認済みのリクエストが 1 件送信されることがあります。有効でない場合、または解決／制限／上限／事前チェックのいずれかの条件を満たさない場合、同じツールはリクエストも認証ヘッダーも送信せず、安全側に失敗します。

ローカルのサブスクリプション／API キーによる有料公開範囲には、公開範囲が有効な場合、3 つの無料ツールに加え、stocktrends_get_stim_latest、stocktrends_get_stim_history、stocktrends_get_indicators_latest、stocktrends_get_indicators_history、stocktrends_get_selections_latest、stocktrends_get_market_regime_latest、stocktrends_get_market_regime_history、stocktrends_get_breadth_sector_latest、stocktrends_get_leadership_summary_latest が含まれ、合計 12 個のツールがあります。公開範囲フラグと実行フラグは表示内容と動作を変更しますが、ローカルの有料公開範囲のツール数は変わりません。

公開と実行の違い

概念	意味
公開	9 つの有料ツールの 定義（stocktrends_get_stim_latest、stocktrends_get_stim_history、stocktrends_get_indicators_latest、stocktrends_get_indicators_history、stocktrends_get_selections_latest、stocktrends_get_market_regime_latest、stocktrends_get_market_regime_history、stocktrends_get_breadth_sector_latest、stocktrends_get_leadership_summary_latest）が MCP クライアントから見える状態です。
実行	有料ツールが呼び出され、各ゲートを通過した場合、承認済みの ST-IM、indicators、base-selections、または market-context エンドポイントに対して、実際の認証済み API リクエストが送信される場合があります（ST-IM／indicators では、解決済みの正規の銘柄 ID も必要です。selections と market-context では、上限付きの常時送信制限も適用されます）。

• 実行ゲートは、公開ゲートより意図的に厳しく設定されています。ツール定義の公開は、実際に請求対象となる呼び出しを承認するよりも、意図的に容易になっています。
• 実行が有効になっていない場合、または上限／料金の事前チェックに失敗した場合、有料ツールはフェイルクローズします。リクエストは送信されず、X-API-Key も付与されず、秘密情報を含まない決定的な拒否結果が返されます。
• 公開リソースと stocktrends_estimate_workflow_cost は、すべてのモードで認証情報を必要としません。API キーを送信することはなく、公開フラグや実行フラグの影響も受けません。

有料ツールの公開を有効にする（公開のみ — 実行なし）

以下の例では、有料ツールの 定義 を公開して、オペレーターが 12 個のツールの構成を確認できるようにします。これはツールの公開のみを目的としています。有料実行は有効にならないため、実際の有料呼び出しには使用しないでください。

# Exposure only: makes the nine paid ST-IM, indicators, base-selections, and
# market-context tool definitions visible.
# This does NOT authorize or perform any paid API call.
export STOCKTRENDS_ENABLE_PAID_TOOLS=true
export STOCKTRENDS_API_KEY="<your-api-key>"        # placeholder — never paste a real key
# Execution stays disabled (its default). Do not set this to true just to test exposure.
export STOCKTRENDS_ENABLE_PAID_EXECUTION=false

PowerShell での同等の設定（Windows）：

# Exposure only: makes the nine paid ST-IM, indicators, base-selections, and
# market-context tool definitions visible.
# This does NOT authorize or perform any paid API call.
$env:STOCKTRENDS_ENABLE_PAID_TOOLS = "true"
$env:STOCKTRENDS_API_KEY = "<your-api-key>"        # placeholder — never paste a real key
# Execution stays disabled (its default). Do not set this to true just to test exposure.
$env:STOCKTRENDS_ENABLE_PAID_EXECUTION = "false"

セッション終了時には、これらの変数を設定したままにせず、クリアしてください。

# POSIX
unset STOCKTRENDS_ENABLE_PAID_TOOLS STOCKTRENDS_API_KEY STOCKTRENDS_ENABLE_PAID_EXECUTION

# PowerShell
Remove-Item Env:STOCKTRENDS_ENABLE_PAID_TOOLS -ErrorAction SilentlyContinue
Remove-Item Env:STOCKTRENDS_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:STOCKTRENDS_ENABLE_PAID_EXECUTION -ErrorAction SilentlyContinue

値を表示せず（名前のみ）、親シェルに STOCKTRENDS_* 変数が残っていないことを確認するには、次を実行します。

# PowerShell — names only, never values
Get-ChildItem Env: | Where-Object { $_.Name -like 'STOCKTRENDS_*' } | Select-Object -ExpandProperty Name

# POSIX — names only, never values
env | grep '^STOCKTRENDS_' | cut -d= -f1

有料変数、特に STOCKTRENDS_API_KEY には、決して setx やシステム／ユーザーの永続環境変数を使用しないでください。 setx は Windows レジストリに書き込み、以降のすべてのシェルや再起動後も設定を保持するため、セッションごとの認証情報の適切な管理が損なわれます。代わりに、上記のセッション単位の $env:／export 形式を使用し、セッション終了時にクリアしてください。

この設定では、MCP クライアントに表示されるツールは合計 12 個です。内訳は、無料ツール 3 個と、ローカルで定義されたサブスクリプション／API キーが必要な有料ツール 9 個です。実行フラグが false で、ゼロ以外の上限も予算上限も設定されていないため、有料リクエストは送信されません。費用をかけずに有料ツールの 公開 状態を確認するには、これで十分です。MCP Inspector で有料ツールが公開されていることを確認する手順は、実際の有料実行を行わない方法で、Phase 5A MCP Inspector Validation Runbook に記載されています（このドキュメントの件数は Phase 4 当時のツール 3 個の構成に基づいています。現在の件数はこの README に記載されています）。

有料の 実行 には、上記の追加ゲート（実行フラグ、必須の事前チェック、明示的なゼロ以外の上限、それをカバーする予算上限）が必要です。実行手順を段階的に説明するライブ実行用の手順書は、意図的に掲載していません。別途承認されたライブ実行を開始する前に満たす必要がある、オペレーター向けの 前提条件 を概念的に説明したもの（ライブ呼び出しコマンドは含みません）は、Phase 5A Operator Safety and Release Checklist を参照してください。インストールのテストだけを目的に、有料実行を有効にしないでください。インストールとツール一覧の確認は、無料モードでも、実行を伴わない有料ツール公開モードでも、すべて実演できます。

x402 チャレンジリレーのフラグ

PR #69 では、既存の9つの有料セマンティックツール名を通じて、PR #66 のモックチャレンジヘルパーを接続します。x402 リレーはデフォルトで無効であり、モックのみです。新しいツール名、プロンプト、リソースは追加しません。ネットワークやリゾルバーへのリクエストは送信せず、API キーを使用せず、証明を受け付けたり転送したりせず、支払いヘッダーを構築せず、有料 API データを返さず、支払いや支出も発生させません。

STOCKTRENDS_ENABLE_X402_RELAY=true の場合、サーバーは API キーによる有料ツールの公開と同じ12ツール構成（3つの無料ツールと既存の9つの有料セマンティックツール）を一覧表示します。チャレンジ実行フラグが設定されていない、またはオフの場合、これら9つの呼び出しはローカルでフェイルクローズし、x402_challenge_unavailable を返します。リレーとチャレンジ実行の両方が文字列どおり true の場合、各有料セマンティックツールは、決定論的なローカルの形式のみの payment_required メタデータを返します。このモードでは、銘柄に依存する4つのツールに正規形式の symbol_exchange が必須となるため、銘柄検索や解決の経路は実行されません。同一のチャレンジ呼び出しをサーバーセッション内で繰り返すと、フェイルクローズして x402_repeated_challenge_call を返します。

x402 フラグは STOCKTRENDS_ENABLE_X402_RELAY、STOCKTRENDS_ENABLE_X402_CHALLENGE_EXECUTION、STOCKTRENDS_ENABLE_X402_LIVE_CHALLENGE_RELAY と、サポート対象外の STOCKTRENDS_ENABLE_X402_PROOF_FORWARDING です。すべてデフォルトではオフです。最初の2つのフラグを有効にするのは、文字列どおりの true のみです。false、0、no、off は無効として扱われます。1、yes、on など、真偽が曖昧な値が設定されている場合、起動時に invalid_config で失敗します。このビルドでは証明の転送はサポートされません。STOCKTRENDS_ENABLE_X402_PROOF_FORWARDING=true を設定すると、フェイルクローズします。有効な x402 リレー設定を STOCKTRENDS_ENABLE_PAID_TOOLS と併用することはできません。混在モードでは、API キーを読み取る前に起動が失敗します。x402 モードと API キーモードの間にフォールバックはありません。

ライブフラグでも、文字列どおりの true のみを有効とする厳格な解析を行い、リレーとチャレンジの両フラグが文字列どおりの true であることを要求します。そうでない場合、起動時に invalid_config／x402_live_challenge_not_enabled で失敗します。3つの条件がすべて満たされると、許可リストに登録されたセマンティックツールの呼び出しは、正規入力、証明、重複、ツールごと、セッションごとの各ゲートを通過した後、対応する Stock Trends API ルートにキーなしの GET リクエストを1回だけ送信できます。このリクエストでは、レビュー済みの API オリジン、手動リダイレクト、資格情報の省略、本文なし、および安全な Accept／User-Agent ヘッダーのみを使用します。API キー、認証ヘッダー、支払いヘッダー、証明、Cookie は送信せず、リゾルバー、カタログ、リソース、再試行、フォールバックの各呼び出しも行いません。

ライブ結果で返すのは、承認済みのステータス、ルート、メソッド、ヘッダー名、トップレベルキー、フィールドカテゴリーのメタデータのみです。x-request-id の値を含む、条件付きチャレンジ値は structuredContent とテキストのどちらにも含めません。セッションでは、ツールごとに最大1回、合計3回までライブチャレンジを予約できます。ネットワーク、ステータス、形式のいずれかで失敗しても、再試行ループを防ぐため予約は消費済みのままになります。状態はメモリ内に保持され、サーバーを再起動するとリセットされます。

Phase 5F x402 Public Mock Wiring Implementation Notes と Phase 5F x402 Live No-Key Challenge Implementation Notes を参照してください。

シークレットの安全性

このサーバーに関連するすべてのサンプル、スクリーンショット、録画、共有アーティファクトに、以下のルールが適用されます。

• API キーをコミットしてはいけません。 このリポジトリ、チェックインされた設定ファイル、コミットされるファイルにキーを含めてはいけません。
• README のサンプル、スクリーンショット、ターミナルの録画、共有チャット、課題報告に、実際の API キーを貼り付けてはいけません。 プレースホルダーのみを使用してください（例：<your-api-key>）。
• 無料／デフォルトモードではキーは不要です。 API キーなしで完全に機能するため、クイックスタートはキーなしで実演する必要があります。
• 公開リソースと stocktrends_estimate_workflow_cost 計画ツールは、API キーを送信しません。 有料設定の有無にかかわらず、認証情報は不要です。
• ローカルで確認する際は、キーを永続的な場所、マシン全体で使う場所、またはコミットされる場所に書き込むのではなく、セッション単位のシェル環境変数（例：単一のシェルで export STOCKTRENDS_API_KEY=<your-api-key>）を優先してください。
• 有料ツールが有効な場合、API キーは、承認済みの有料 ST-IM、インジケーター、基本の selections/latest、市場コンテキスト（market/regime/latest、market/regime/history、breadth/sector/latest、leadership/summary/latest）の各エンドポイントに対して、X-API-Key ヘッダーとしてのみ送信され、すべてのゲートを通過した後に限られます。認証情報を必要としない銘柄解決（/v1/instruments/lookup、/v1/instruments/resolve）、価格カタログ、および stocktrends://leadership/definitions 公開リソースには送信されません。Authorization: Bearer へのフォールバックはありません。
• キーがログに記録されたり、エラー、拒否応答、返却データに表示されたりすることはありません。

リリース前に、Phase 5A Operator Safety and Release Checklist に記載されたシークレット安全性の手動スキャンを実行し、実際のキー、値が設定された認証ヘッダー、またはシークレットを含むアーティファクトがコミットされていないことを確認してください。<your-api-key> のようなプレースホルダーは使用できますが、実在するように見えるシークレットは使用できません。

現在の状況

このリポジトリは、Streamable HTTP 経由で https://mcp.stocktrends.com/mcp にデプロイされたパブリックなリモート MCP を稼働させています。ツールは19個（無料が3個、x402 V2 の有料ツールが16個）、リソースは10個、プロンプトは0個です。有料のリモート機能には、GET ツールが12個、分析用 POST ツールが4個含まれます。MCP 固有の x402/payment と x402/payment-response によるメタデータ交換を使用し、受け付けた認証情報を PAYMENT-SIGNATURE で上流に転送します。ローカル stdio は、ローカルプロセス起動時のデフォルトであり、無料／デフォルト機能、別途ゲートで制御されるサブスクリプション／API キーによる有料ツール、任意のデフォルト無効の x402 チャレンジ検査／リレーのみをサポートします（支払い、証明の転送、支払いヘッダー、有料データ、支出はありません）。

含まれるもの：

• ライブの公開 Streamable HTTP リモート MCP と、別途サポートされるローカル stdio トランスポート（ローカルプロセスの起動時のデフォルト）。
• 公開 Stock Trends API リソース、3 つの無料リモート MCP ツール、およびデプロイ済みの 16 個の x402 V2 有料リモート MCP ツール群。
• リクエスト時に取得する動作。起動時の API 取得は不要です。
• 3 つの無料リモート MCP ツール：stocktrends_estimate_workflow_cost、stocktrends_lookup_instruments、stocktrends_resolve_instrument。
• デプロイ済みの 16 個の x402 V2 有料リモート MCP ツール：12 個の GET ツールと、公開リモート MCP に記載された 4 個の分析用 POST ツール。支払いの認可情報は x402/payment を通じてクライアントから提供されます。サーバーはそれを許可リストに登録された Stock Trends API エンドポイントにのみ PAYMENT-SIGNATURE として転送し、決済の確認結果を x402/payment-response を通じて報告します。購入者のウォレットを保有したり、ウォレットで署名したりすることはありません。
• 条件付きのペア有料 ST-IM ツール（stocktrends_get_stim_latest、stocktrends_get_stim_history）、ペア有料インジケーターツール（stocktrends_get_indicators_latest、stocktrends_get_indicators_history）、ベースとなる ST-IM 選択ユニバースツール（stocktrends_get_selections_latest）、および 4 つの市場コンテキストツール（stocktrends_get_market_regime_latest、stocktrends_get_market_regime_history、stocktrends_get_breadth_sector_latest、stocktrends_get_leadership_summary_latest）。有料モードが API キーとともに明示的に有効化されている場合にのみ公開されます（無料ツール 3 個＋有料ツール 9 個＝合計 12 個）。ライブのサブスクリプション／API キーによる実行（X-API-Key のみ）は、2 段階ゲートのポリシー（有料ツールフラグ、API キー、個別の STOCKTRENDS_ENABLE_PAID_EXECUTION 実行時フラグ、権威ある静的価格設定／事前チェック、ファミリー単位のカタログ照合、ゼロ以外のローカル上限（上限をカバーする予算も必要））を通過した場合に限り実行されます。さらに、インジケーターの場合は、認証情報なしで生のシンボルまたはベアシンボルが一意の正規 ID に解決された場合に限られます。選択および市場コンテキストの場合は、リスト形式の広範な取得／上限の安全制御（常に送信される上限制限、1 回の取得、バルク処理／再試行なし、同一呼び出しの繰り返しループ拒否）の下でのみ実行されます。それ以外の場合は、リクエストも認証／支払いヘッダーも送信せず、フェイルクローズします。条件付き有料 ST-IM ツール、条件付き有料インジケーターツール、条件付き有料選択ツール、条件付き有料市場コンテキストツールのセクションを参照してください。
• MCP プロンプトはありません。
• デフォルト／公開機能では API キーは不要です。
• 既存の 9 個の有料セマンティックツール名を通じた、デフォルトで無効の公開モック x402 接続。ローカルでの形状のみのチャレンジ結果、正規シンボルの強制、同一呼び出しの繰り返し拒否を備え、ネットワーク／証明／支払い／支出の経路はありません。
• 同じ 9 個のセマンティックツールを通じた、デフォルトで無効のライブ・キー不要 x402 チャレンジリレー。個別の第 3 フラグと、前提となる両方のフラグが有効な場合にのみ有効になります。ツールごとに 1 リクエスト、サーバーセッションあたり 3 リクエストに制限され、形状メタデータのみを中継します。API キー、証明、支払いヘッダー、支払い、支出、有料出力、リゾルバー、再試行、フォールバックの経路はありません。
• 内部の有料モード設定、ホストの強制、エンドポイントとツールの許可リスト連携、X-API-Key のみを使う認証の構築、機密情報の秘匿、静的エンドポイント価格設定ポリシー、セッションごとのメモリ内支出上限、再試行なしの単一試行フェッチ、モックのみの検証。

除外項目：

• 自動テストでのライブ API 検証（コードには実行パスが存在しますが、テストではモックのみが実行されます。ライブ検証には、マージ後に運用担当者による別途の承認が必要です）。
• ウォレットの保管、ウォレット設定、秘密鍵の取り扱い、支払いへの署名、自律的な支出、自動支払い再試行、OAuth、MPP。デプロイ済みのリモート MCP は、クライアントから提供された x402 認証情報を転送し、確定済みの決済を処理します。これとは別に、個別に制御されるローカル stdio x402 リレーは、チャレンジのみで、キーなし、証明の転送なし、支払いなし、支出なし、形状メタデータのみです。
• Authorization: Bearer フォールバック。
• 顧客 API キーの転送と、リモート OAuth／サブスクライバー認証。デプロイ済みリモート MCP の x402 による有料実行は、支払いクライアントが開始するものであり、API キーやウォレットを保管するサービスではありません。
• データベースまたはコントロールプレーンへのアクセス。
• /v1/ai/tools または /v1/workflows からの動的 MCP 登録。
• インテリジェンスエージェントによる再計算、生成されたガイダンス、生成された調査、または並列推論レイヤー。

ローカル開発

専用のブランチまたはワークツリーで作業してください。main を直接変更しないでください。

API キー、ベアラートークン、支払いヘッダー、ウォレット情報、データベース認証情報、その他の秘密情報をこのリポジトリに保存しないでください。

依存関係をインストールします。

npm install

検証を実行します。

npm run typecheck
npm test
npm run build

ビルド済みの stdio MCP サーバーを起動します。

npm run build
npm start

開発中にローカルで TypeScript を実行する場合：

npm run dev

人が読める出力を期待して、stdio サーバーをターミナルから直接実行しないでください。stdout は MCP JSON-RPC メッセージ用に予約されています。

環境変数

すべての変数は任意です。デフォルトではサーバーは無料モードで動作します。影響範囲列は、変数がすべてのモード、有料ツールの公開、または有料実行のいずれに適用されるかを示します（有料モードの設定を参照）。秘密情報に該当するのは STOCKTRENDS_API_KEY のみです。

変数	影響するモード	デフォルト	動作とシークレットの安全性に関する注意事項
STOCKTRENDS_API_BASE_URL	すべてのモード	https://api.stocktrends.com	承認済みの Stock Trends HTTPS オリジンである必要があります。シークレットではありません。
STOCKTRENDS_MCP_TRANSPORT	すべてのモード	stdio	使用できる値は stdio と streamable-http です。ローカル起動時のデフォルトは stdio です。デフォルトでは、streamable-http は10個のリソースと3個の無料ツールを公開し、ローカル API キー有料モード、およびローカルの x402 リレー／チャレンジ／証明転送設定を拒否します。別の方法として、個別の STOCKTRENDS_ENABLE_REMOTE_X402_STIM=true による有効化でのみ、19個のツールからなる本番スタイルの Remote x402 サーフェスをホストできます。シークレットではありません。
STOCKTRENDS_MCP_HTTP_BIND_ADDRESS	Streamable HTTP のみ	127.0.0.1	空白を含まない空でないホスト名または IP アドレスを指定します。ループバック以外のアドレスにバインドする場合は、STOCKTRENDS_MCP_HTTP_ALLOWED_HOSTS が必要です。シークレットではありません。
STOCKTRENDS_MCP_HTTP_PORT	Streamable HTTP のみ	3000	1～65535の整数です。シークレットではありません。
STOCKTRENDS_MCP_HTTP_ALLOWED_HOSTS	Streamable HTTP のみ	なし	任意のカンマ区切りのワイルドカードを含まないホスト名許可リストです。ループバック以外のバインドアドレスでは必須です。シークレットではありません。
STOCKTRENDS_MCP_HTTP_ALLOWED_ORIGINS	Streamable HTTP のみ	なし	Origin の検証に使用する、任意のカンマ区切りのワイルドカードを含まない許可リストです。未設定の場合、HTTP サーバーは設定済みであればホスト許可リストを使用し、そうでなければループバック Origin の検証を行います。シークレットではありません。
STOCKTRENDS_MCP_LOG_LEVEL	すべてのモード	warn	通常のログは stderr に出力され、stdout には出力されません。シークレットではありません。
STOCKTRENDS_ENABLE_PAID_TOOLS	有料ツールの公開	false	公開フラグです。API キーが設定された状態で true にすると、ペアになった有料 ST-IM ツールの定義2つ、ペアになった有料 indicators ツールの定義2つ、基本 selections ツールの定義1つ、市場コンテキストツールの定義4つが公開されます（無料ツール3つと有料ツール9つで合計12個。内部リゾルバーヘルパーは、公開されている2つのディスカバリーツールとは別です）。これだけでは実行されません。実行には STOCKTRENDS_ENABLE_PAID_EXECUTION も必要です。シークレットではありません。
STOCKTRENDS_API_KEY	有料ツールの公開と実行	なし	シークレットです。すべてのドキュメント、例、スクリーンショット、共有する成果物ではプレースホルダー（<your-api-key>）を使用してください。実際の値をコミットしたり貼り付けたりしないでください。 STOCKTRENDS_ENABLE_PAID_TOOLS=true の場合にのみ読み込まれ、プロセス内に保持されます。すべてのゲートを通過した後、承認済みオリジンの許可リスト対象である有料 ST-IM、indicators、基本の selections/latest、市場コンテキストのエンドポイントに対してのみ、X-API-Key ヘッダーとして送信されます（Authorization: Bearer へのフォールバックはありません）。公開リソース（stocktrends://leadership/definitions を含む）、コスト見積もりの計画ツール、価格カタログ、認証情報不要の instrument リゾルバーには送信されません。また、ログに記録されたり、エラー、拒否、返却データに公開されたりすることもありません。
STOCKTRENDS_ENABLE_PAID_EXECUTION	有料実行	false	公開フラグとは別の実行フラグです。GET /v1/stim/latest、GET /v1/stim/history、GET /v1/indicators/latest、GET /v1/indicators/history、GET /v1/selections/latest、GET /v1/market/regime/latest、GET /v1/market/regime/history、GET /v1/breadth/sector/latest、GET /v1/leadership/summary/latest へのサブスクリプション／API キーを使用したライブ呼び出しを実行するには、これを true にするとともに有料ツールフラグと API キーを設定し、権威ある静的価格設定／プリフライトと、ファミリー単位のカタログ照合を行い、0より大きい呼び出し上限を1つ以上と、そのコストをカバーする予算上限を設定する必要があります（indicators では、さらに安全に解決された正規 ID が必要です。selections と市場コンテキストでは、常に送信する制限に上限を設け、同一呼び出しの繰り返しに対するループ安全性も適用されます）。このフラグだけでは（ツールフラグ／キーがない場合）、何も公開も実行もされません。シークレットではありません。
STOCKTRENDS_ENABLE_X402_RELAY	x402 ツールの公開	false	リテラルの true の場合にのみ、API キーなしで既存の有料セマンティックツール名9個が公開されます（無料ツール3個とリレーツール9個で合計12個）。false、0、no、off は無効化します。曖昧な truthy 値が指定された場合、起動に失敗します。チャレンジフラグも有効にしない限り、呼び出しは fail closed で失敗します。STOCKTRENDS_ENABLE_PAID_TOOLS とは併用できません。シークレットではありません。
STOCKTRENDS_ENABLE_REMOTE_X402_STIM	本番スタイルの Remote x402 有効化	false	STOCKTRENDS_MCP_TRANSPORT=streamable-http の場合にのみ適用されます。リテラルの true にすると、3つの無料ツールと16個の有料 x402 V2 ツール（合計19個）が有効になります。これはローカル API キー有料モードやローカルチャレンジリレーとは別のもので、これらは引き続きこの HTTP 設定とは併用できません。サーバーにウォレットの管理、秘密鍵、決済署名の権限を与えるものではありません。シークレットではありません。
STOCKTRENDS_ENABLE_X402_CHALLENGE_EXECUTION	x402 チャレンジの動作	false	STOCKTRENDS_ENABLE_X402_RELAY=true の場合にのみ使用できます。リテラルの true にすると、個別のライブフラグも true でない限り、決定論的なローカル PR #64 の形式のみのモック結果を維持します。リゾルバーの検索、認証、証明、決済、支出は行いません。シークレットではありません。
STOCKTRENDS_ENABLE_X402_LIVE_CHALLENGE_RELAY	キーなしのライブチャレンジリクエスト	false	リテラルの true にした場合にのみ有効になります。リレーとチャレンジの両フラグがリテラルの true である必要があり、そうでない場合は x402_live_challenge_not_enabled で起動に失敗します。受け付けた呼び出しごとに、正確に許可リストへ登録されたルートへのキーなし GET を最大1回まで許可します。ツールごとに最大1回、サーバーセッション全体で最大3回に制限されます。リダイレクトは手動で処理し、認証情報は省略し、本文、API キー／認証／決済／証明ヘッダーは使用しません。また、リゾルバー／カタログ／リソースへのサイドコール、リトライ／フォールバック、有料データ、決済、支出もありません。条件付きチャレンジ値は省略されます。シークレットではありません。
STOCKTRENDS_ENABLE_X402_PROOF_FORWARDING	サポート対象外の x402 証明転送	false	証明の転送は引き続きサポートされません。オフを示す値は受け付けられますが、true にすると invalid_config／証明転送が有効化されていない状態での起動失敗となります。証明スキーマ、保存、転送、決済ヘッダー、検証は追加されません。シークレットではありません。
STOCKTRENDS_REQUIRE_PRICING_PREFLIGHT	有料実行	true	価格設定／プリフライトの方針です。プリフライトは必須です。これを false に設定すると、要件が緩和されるのではなく、有料実行は拒否されます（fail closed）。シークレットではありません。
STOCKTRENDS_MAX_PAID_CALLS_PER_SESSION	有料実行	0	セッションあたりの有料呼び出し上限です。0 はすべての有料呼び出しを拒否します。ライブ実行には、0より大きい明示的な値が必要です。セッションごとにメモリ内で管理され、再起動するとリセットされます。シークレットではありません。
STOCKTRENDS_MAX_PAID_CALLS_PER_TOOL	有料実行	0	ツールごとの有料呼び出し上限です。0 は拒否を意味し、0より大きい明示的な値が必要です。セッションごとにメモリ内で管理され、再起動するとリセットされます。シークレットではありません。
STOCKTRENDS_MAX_STC_PER_SESSION	有料実行	なし	STC 予算の上限です。STC コストが0より大きい場合、STC 上限がなければ拒否されます。ST-IM のルールではコストが0より大きいため、実質的に予算上限は必須です。シークレットではありません。
STOCKTRENDS_MAX_USD_PER_SESSION	有料実行	なし	USD 予算の上限です。USD コストが0より大きい場合、USD 上限がなければ拒否されます。シークレットではありません。

公開リソース

サーバーは以下のリソースを登録します。

MCP リソース URI	バックエンドエンドポイント
stocktrends://api/openapi	GET /v1/openapi.json
stocktrends://ai/context	GET /v1/ai/context
stocktrends://ai/tools	GET /v1/ai/tools
stocktrends://workflows	GET /v1/workflows
stocktrends://methodology/stim	GET /v1/meta/stim
stocktrends://methodology/indicators	GET /v1/meta/indicators
stocktrends://methodology/inference	GET /v1/meta/inference
stocktrends://pricing/catalog	GET /v1/pricing/catalog
stocktrends://proof/market-edge	GET /v1/ai/proof/market-edge
stocktrends://leadership/definitions	GET /v1/leadership/definitions

10 個すべてのリソースは、どのモードでも認証情報なしで利用できます（リクエスト時に取得し、API キーは一切不要です）。stocktrends://leadership/definitions は、リーダーシップ指標と分類体系の定義を提供します（認証情報なしの読み取りによって、公開かつ無料であることを確認済みです）。これは有料のリーダーシップ要約ツールを解釈するための補足資料です。API キーを要求することはなく、有料の許可リストにも含まれず、有料の料金ルールとして複製されることもありません。

候補となるインテリジェンスリソースは、キーなしでの公開確認に成功するまで除外されます。

除外対象の候補エンドポイント	理由
GET /v1/intelligence/discovery	2026-07-07 のフェーズ 1 およびフェーズ 2 の確認時に、キーなしでの確認結果が 503 application/json でした。
GET /v1/intelligence/editorial/latest/preview	2026-07-07 のフェーズ 1 およびフェーズ 2 の確認時に、キーなしでの確認結果が 503 application/json でした。

公開プランニングツール

現在のソースヘッドのローカルデフォルト／無料モードでは、公開／無料の MCP ツールを 3 つ登録します。ワークフロー計画ツールは以下のとおりです。

MCP ツール	バックエンドエンドポイント	目的
stocktrends_estimate_workflow_cost	GET /v1/cost-estimate	有料実行の前に、予算策定／計画用としてワークフローレベルのコストを見積もります。

このツールは API キーや認証ヘッダーを送信せず、有料エンドポイントや /v1/pricing/catalog を呼び出しません。また、有料実行や支払いを承認せず、 x402 支払い、ウォレット、OAuth、データベース、コントロールプレーンの動作も実装しません。 ローカルのデフォルト／無料モードでは、追加の無料の銘柄検索ツール 2 つも登録されます。

MCP ツール	バックエンドエンドポイント	目的
stocktrends_lookup_instruments	GET /v1/instruments/lookup	支払いや API キーなしで、一致する Stock Trends の銘柄を検索します。
stocktrends_resolve_instrument	GET /v1/instruments/resolve	支払いや API キーなしで、Stock Trends の銘柄識別子を解決します。

デプロイ済みのリモート MCP でも同じ 3 つの無料ツールを利用できます。詳しくは公開リモート MCPを参照してください。

条件付き有料 ST-IM ツール（サブスクリプション/API キーによる実行）

STOCKTRENDS_ENABLE_PAID_TOOLS=true で、STOCKTRENDS_API_KEY が設定されている場合、サーバーはペアになった有料 ST-IM ツールの定義、ペアになった有料インジケーター ツールの定義、基本選択ツールの定義、および 4 つのマーケットコンテキストツールの定義も登録します（無料ツール 3 つと有料ツール 9 つ、合計 12 個。［有料モードの設定］(#paid-mode-configuration)を参照）。それ以外の場合は、無料ツール 3 つだけが登録されます。公開の有無は実行フラグとは独立しています。

MCP ツール	エンドポイント	実行
stocktrends_get_stim_latest	GET /v1/stim/latest	すべてのゲートを通過した場合に限り、サブスクリプション/API キーを使用してライブ呼び出しを行います。それ以外の場合は、フェイルクローズで失敗します。
stocktrends_get_stim_history	GET /v1/stim/history	すべてのゲートを通過した場合に限り、サブスクリプション/API キーを使用してライブ呼び出しを行います。それ以外の場合は、フェイルクローズで失敗します。

これら 2 つのツールは常にペアで登録されます（履歴と最新の結果をセットにするルール）。呼び出しのたびに、プリフライト、認証、フェッチの前に入力を厳密に検証します（symbol_exchange を優先する銘柄識別子、N,Q,A,B,T,I のいずれかの取引所、履歴の日付および limit の範囲 1～2600）。ライブ呼び出しが行われるのは、STOCKTRENDS_ENABLE_PAID_EXECUTION=true で、API キーが設定され、信頼できる静的価格情報を使ったプリフライトが解決され、静的価格情報のミラーがライブの /v1/pricing/catalog メタデータと照合済みであり（認証情報不要の読み取り。静的価格情報だけでは呼び出しを許可できず、不一致または利用不可の場合はフェイルクローズ）、かつゼロ以外のローカル上限（さらに、そのゼロ以外のコストをカバーする予算上限）を満たす場合に限られます。その後、X-API-Key のみを使用して GET を正確に 1 回送信します（Authorization: Bearer なし、支払いヘッダーなし、自動再試行なし、x402 なし）。認証情報を含む境界は、承認済みの有料エンドポイント 9 つ（/v1/stim/latest、/v1/stim/history、/v1/indicators/latest、/v1/indicators/history、/v1/selections/latest、/v1/market/regime/latest、/v1/market/regime/history、/v1/breadth/sector/latest、/v1/leadership/summary/latest）のみに限定されます。公開の銘柄検索ルート（/v1/instruments/lookup、/v1/instruments/resolve）、認証情報不要の /v1/leadership/definitions リソースルート、延期された選択ルート（/v1/selections/history、/v1/selections/published/*）、延期されたマーケットコンテキストルート（/v1/market/regime/forecast、/v1/breadth/sector/history、/v1/leadership/rotation/history）、およびその他の昇格対象外エンドポイントに X-API-Key が渡されることはありません。銘柄識別子はハイフン形式（SYMBOL-EXCHANGE）で API に送信され、アンダースコア形式の正規形が転送されることはありません。成功したレスポンスは、透過的な MCP メタデータ（paid_execution_authorized: true、api_request_sent: true、auth_header_sent: true、payment_header_sent: false、observed_cost: null、payment_status: null）でラップされ、API のペイロードは api_data 内にそのまま保持されます。いずれかのゲートで失敗した場合は、秘密情報を含まない決定的な拒否が返され、paid_execution_authorized: false となり、リクエスト／認証／支払いヘッダーは送信されません。自動検証はモックのみです。テストではライブ API 呼び出しは実行されません。［フェーズ 4 有料 ST-IM ライブ実行（サブスクリプション）実装ノート］(docs/PHASE4_PAID_STIM_LIVE_EXECUTION_SUBSCRIPTION_IMPLEMENTATION_NOTES.md)およびdocs/SECURITY_MODEL.md §15を参照してください。

条件付き有料指標ツール（サブスクリプション／API キーによる実行）

API キーを使って有料ツールを有効にすると、サーバーは ST-IM ペアに加えて、対応する有料指標ツールの定義も登録します（有料モードの設定で説明している、公開対象となる 12 ツールの構成に含まれます）。これらは常にセットで登録され（履歴と最新のペアのルール）、ST-IM ペアとまったく同じように動作しますが、有料処理に進む前に内部の、認証情報を使わない銘柄リゾルバーが実行される点が異なります。

MCP ツール	エンドポイント	実行
stocktrends_get_indicators_latest	GET /v1/indicators/latest	安全な正規 ID が解決され、すべてのゲートを通過した場合に限り、サブスクリプション／API キーを使ってライブ呼び出しを行います。それ以外の場合はフェイルクローズします。
stocktrends_get_indicators_history	GET /v1/indicators/history	安全な正規 ID が解決され、すべてのゲートを通過した場合に限り、サブスクリプション／API キーを使ってライブ呼び出しを行います。それ以外の場合はフェイルクローズします。

入力には、正規形式の symbol_exchange（アンダースコア形式、例：IBM_N）、明示的な symbol と exchange（取引所は N,Q,A,B,T,I のいずれか）、または symbol のみの生の値を指定できます。さらに、任意で cs_only を指定でき、履歴の場合は start／end と limit（1～2600。省略時の API のデフォルトは 260）も指定できます。ID は、有料処理に進む前に認証情報を使わずに解決されます。

• 正規形式の symbol_exchange はそのまま信頼され（検索呼び出しは行わず）、ハイフン形式（IBM-N）で API に送信されます。
• 明示的な symbol と exchange は、指定された取引所と同じ値を明示的な prefer_exchange として指定し、GET /v1/instruments/resolve で検証されます。デフォルトの N が使われることはありません。
• symbol のみの生の値は、GET /v1/instruments/lookup で曖昧さを解消します。一致するものがちょうど 1 件なら、認証情報を使わずに解決されます。**複数の候補がある場合は、候補の symbol_exchange を提示してフェイルクローズし、有料呼び出しは行いません。**リゾルバーは、シンボルのみが指定された場合に /v1/instruments/resolve のデフォルト prefer_exchange=N に意図的に依存しません。そのため、サーバーがお客様に代わって取引所を黙って選ぶことはありません。

安全な正規 ID が 1 つに定まった後にのみ、このツールは ST-IM と同じ有料ゲートを実行します。ゲートには、権威ある静的料金（ファミリー固有のミラー：indicators_latest_paid は 0.0035 STC、indicators_history_paid は 0.01 STC）、そのミラーとライブの /v1/pricing/catalog メタデータとの認証情報を使わない照合（静的料金だけでは呼び出しは許可されず、不一致または利用不可の場合はフェイルクローズします）、ゼロ以外のローカル上限、および実行フラグが含まれます。その後、X-API-Key のみを使用して GET を 1 回だけ送信します（Authorization: Bearer、支払いヘッダー、自動再試行、x402 は使用しません）。銘柄検索とカタログの読み取りに API キーが渡されることはありません。この有料指標リゾルバーは、2 つの公開検索ツールとは別の内部ヘルパーであるため、デフォルト／無料のツール構成は 3 ツールのままです。成功した応答では、API ペイロードがそのまま api_data に保持され、instrument_resolution（曖昧な場合は candidate_matches も含む）を含む mcp_metadata が追加されます。observed_cost／payment_status は null のままであり、値が捏造されることはありません。自動検証はモックのみで行われ、テスト中にライブ API 呼び出しが実行されることはありません。Phase 5B Indicators Implementation Notesを参照してください。

条件付き有料セレクションツール（サブスクリプション/API キーによる実行）

API キーを使って有料ツールを有効にすると、サーバーは ST-IM とインジケーターのペアに加えて、単一のベース ST-IM セレクションユニバースツールも登録します（有料モードの設定で説明している、有料モードで公開される 12 個のツールに含まれます）。同じゲートポリシーに従って他の有料ツールと同様に動作し、単一の行ではなくユニバース／リストを返すため、リスト形式に特化した広範なスイープ／上限安全制御が追加されています。銘柄ではなく取引所を対象とするため、銘柄リゾルバーは使用しません。

MCP ツール	エンドポイント	実行
stocktrends_get_selections_latest	GET /v1/selections/latest	すべてのゲートを通過し、上限が設定範囲内にある場合に限り、サブスクリプション/API キーを使ってライブ呼び出しを行います。それ以外の場合はフェイルクローズします。

このツールはベース ST-IM セレクションユニバース（API が prob13wk 順にランク付け）を表示します。厳密な公開済み STIM Select リストではありません。公開済みリストは別のエンドポイント（/v1/selections/published/latest）で、公開済みのしきい値を適用します。このツールはベース行を公開済みリストとして表示せず、公開済みのしきい値をローカルで適用せず、行をローカルでランク付け、しきい値処理、スコアリング、フィルタリング、または再計算することもありません。mcp_metadata にはベースユニバースの出所情報が含まれているため、2 つの表示内容を混同できません。今回の追加では、selections/history、selections/published/*、公開セレクションリソースは追加されません。

入力（すべて任意、厳格なスキーマで未知のキーは拒否）：exchange（N,Q,A,B,T,I のいずれか）、min_prob13wk（0～1）、limit（整数 1～250、デフォルト 50）、include_data（デフォルト false）、include_mast（デフォルト false）、cs_only（デフォルト true）。min_prob13wk、exchange、cs_only、および include_* フラグは API にのみ渡され、ローカルでは適用されません。

広範なスイープ／上限の安全性（API 独自のデフォルト 2000／最大 20000 よりも大幅に厳格）：

• 明示的な limit は必ず送信されます（デフォルト 50）。API のデフォルト 2000 が適用されることはありません。ハード上限は 250 です。250 を超える、1 未満、整数でない、配列、またはいずれかのセンチネル値である limit は、料金確認／認証／フェッチの前にフェイルクローズします。暗黙の上限切り下げは行いません。全行／ユニバースをスイープするモードはありません。
• 呼び出し 1 回につき GET は正確に 1 回です。ページネーション、オフセットを進めながらの走査、取引所をまたぐ自動反復、一括組み立て、バックグラウンド更新、429／5xx 発生時の自動再試行は行いません（フェイルクローズ）。
• 呼び出し上限はデフォルトで拒否され、0.05 STC のコストをカバーする STOCKTRENDS_MAX_STC_PER_SESSION が必要です。セッション内で同一のベースセレクションを繰り返し呼び出すと、暗黙に再課金するのではなく、repeated_identical_selection_call でフェイルクローズします。

料金設定には、selections ファミリーの新しい静的ミラー（selections_latest_paid、0.05 STC）を使用します。ライブの /v1/pricing/catalog メタデータとの照合は、認証情報なしかつファミリー単位で行います（ルールの欠落／重複、コストの不一致、または STC 単位の欠落／非対応／競合があればフェイルクローズします。ST-IM／インジケーター／公開済みのミラーでは条件を満たしません）。すべてのゲートを通過した場合に限り、X-API-Key のみを使用して GET を正確に 1 回送信します（Authorization: Bearer、支払いヘッダー、x402、再試行はありません）。成功したレスポンスでは、API のペイロードをそのまま api_data に保持し、ベースと公開済みの出所情報、effective_limit、返された行数を含む mcp_metadata を追加します。observed_cost／payment_status は null のまま保持され、捏造されることはありません。自動検証はモックのみです。テストではライブ API 呼び出しを行いません。Phase 5C Selections/Latest の実装メモを参照してください。

条件付き有料マーケットコンテキストツール（サブスクリプション/API キーによる実行）

API キーを使用して有料ツールを有効にすると、サーバーは従来のファミリーに加えて Phase 5D のマーケットコンテキストツールを 4 つ登録します。これにより、ローカルのサブスクリプション／API キーで利用できる有料ツールは、合計 12 個（無料 3 個、有料 9 個）になります。これらは、同じゲートポリシーに従う他の有料ツールと同様に動作し、データが週次頻度かつ市場単位であることを踏まえたマーケットコンテキスト向けの制限安全策も適用されます。いずれもシンボルをキーにしていないため、銘柄リゾルバーは関与しません。

MCP ツール	エンドポイント	コスト	制限（常に送信）
stocktrends_get_market_regime_latest	GET /v1/market/regime/latest	0.15 STC	—（スナップショット。入力は厳密に空である必要があり、不明なキーは拒否されます）
stocktrends_get_market_regime_history	GET /v1/market/regime/history	0.25 STC	limit のデフォルトは 12、ハード上限は 52（API 自体の最大値）。任意の start_date（YYYY-MM-DD）はそのまま渡されます
stocktrends_get_breadth_sector_latest	GET /v1/breadth/sector/latest	0.1 STC	limit のデフォルトは 50、ハード上限は 250。group_level のデフォルトは sector で、常に送信されます
stocktrends_get_leadership_summary_latest	GET /v1/leadership/summary/latest	0.25 STC	limit_overall のデフォルトは 50、ハード上限は 200。limit_bucket のデフォルトは 20、ハード上限は 50

アドバイスではなく、コンテキストです。 これらのツールは、Stock Trends API が作成したマーケットコンテキストをそのまま転送し、推奨へと変換することはありません。レジームラベルはマーケットコンテキストであり、取引の推奨ではありません。ブレッドスの各行は参加状況のコンテキストであり、行動の根拠となる確認シグナルではありません。リーダーシップテーブルはローテーションのコンテキストであり、銘柄選定ではありません。アダプターはローカルでレジームを計算したり、ブレッドスを再集計したり、リーダーシップを再順位付け／再分類／しきい値処理したりしません。また、買い／売り／保有／配分や適合性に関する出力も生成しません。

追加の入力ポリシーとして、exchange（N,Q,A,B,T,I のいずれか）、ブレッドスの cs_only／include_unknown／min_price／min_volume、およびリーダーシップの min_rsi／min_mt_cnt（0～500）は、指定された場合にのみ送信される検証済みのパススルー項目です。API のデフォルトが適用されるよう、指定されない場合は送信されません。これらがローカルで適用されることはありません。weekdate は、いずれの最新ツールでも意図的に公開されていません（最新ルート経由で履歴を再構成するスナップショットのタイムトラベルは行いません）。また、vol_scale（上限のないレガシー乗数）と type（検証済みの列挙値がない）は公開されていません。これらはすべて、不明なキーとして拒否されます。無効な制限値、範囲外の制限値、配列形式の制限値、センチネル値の制限値は、価格設定／認証／フェッチの前にフェイルクローズし、上限値への切り詰めは行いません。呼び出しごとに GET は厳密に 1 回だけです。ページネーション、日付範囲の網羅的な取得、取引所の反復、バルクでの組み立て、自動再試行は行いません。また、同一の呼び出し（同じツールと正規化済みパラメーター。パラメーターなしの regime-latest のシグネチャは固定）を繰り返すと、週次データへの再課金を避けるため、repeated_identical_market_context_call でフェイルクローズします。 価格設定では、新しくファミリー単位でスコープされた3つの静的ミラーを使用します（ファミリーmarketのmarket_regime_latestは0.15 STC、market_regime_historyは0.25 STC — 検証済みのルールIDに_paidサフィックスはありません。ファミリーbreadthのbreadth_sector_latest_paidは0.1 STC。ファミリーleadershipのleadership_summary_latest_paidは0.25 STC）。それぞれ、ライブの/v1/pricing/catalogメタデータと認証情報なしで照合し、同じフェイルクローズチェック（ルールの欠落／重複、エンドポイント／ファミリー／コスト／単位の不一致、paid以外の分類）を行います。保留中のルート/v1/market/regime/forecast、/v1/breadth/sector/history（APIのデフォルト値／最大値は200000／500000 — このアダプターからは到達できません）、および/v1/leadership/rotation/historyは実装も昇格もされず、endpoint_not_allowlistedとして拒否されます。成功したレスポンスでは、APIペイロードをapi_dataにそのまま保持し、コンテキストであり助言ではないことを示すプロベナンス、effective_limits、算出可能な場合は返却行数、APIから報告された場合に限り週日付を含むmcp_metadataを追加します。observed_cost／payment_statusは引き続きnullであり、捏造されることはありません。自動検証はモックのみです。テストではライブAPI呼び出しを行いません。Phase 5D Market-Context Implementation Notesおよびdocs/SECURITY_MODEL.md §17を参照してください。

ドキュメント

• アーキテクチャ上の決定
• MCP サーバーアーキテクチャ
• API 機能カバレッジ監査
• セキュリティモデル
• フェーズ 1 実装メモ
• フェーズ 1 検証レポート
• フェーズ 1 実装ノート
• フェーズ 2 公開メタデータと有料ツールの境界に関するメモ
• フェーズ 2 公開メタデータ実装ノート
• フェーズ 3 有料ツールの認証と支出設計メモ
• フェーズ 3 有料認証基盤の実装ノート
• フェーズ 4 初の有料ツール契約メモ
• フェーズ 4 API 契約確認メモ
• フェーズ 4 価格設定／事前確認基盤の実装ノート
• フェーズ 4 価格設定／事前確認基盤の検証レポート
• フェーズ 4 コスト見積もり MCP 統合メモ
• フェーズ 4 コスト見積もり計画ツールの実装ノート
• フェーズ 4 コスト見積もり計画ツールの検証レポート
• フェーズ 4 初の有料 ST-IM ツール事前確認設計メモ
• フェーズ 4 有料 ST-IM 基盤（実行なし）の実装ノート
• フェーズ 4 有料 ST-IM 基盤（実行なし）の検証レポート
• フェーズ 4 有料 ST-IM ライブ実行設計メモ
• フェーズ 4 有料 ST-IM ライブ実行（サブスクリプション）の実装ノート
• フェーズ 4 有料 ST-IM ライブ実行（サブスクリプション）の検証レポート
• フェーズ 5A MCP Inspector 検証手順書
• フェーズ 5A 運用担当者向け安全性とリリースチェックリスト
• フェーズ 5B インジケーターと金融商品解決の設計メモ
• フェーズ 5B インジケーター契約検証メモ
• フェーズ 5B インジケーター実装ノート
• フェーズ 5B インジケーターの管理下検証計画
• フェーズ 5B インジケーターの本番稼働準備完了承認
• フェーズ 5C 次の機能選定メモ
• フェーズ 5C 銘柄選定／最新情報の設計・契約検証メモ
• フェーズ 5C 銘柄選定／最新情報の実装ノート
• フェーズ 5C 銘柄選定／最新情報の管理下検証計画
• フェーズ 5C 銘柄選定／最新情報の管理下検証レポート
• フェーズ 5C 銘柄選定／最新情報の本番稼働準備完了承認
• フェーズ 5D MCP 起動機能ロードマップと利用可能なエンドポイント選定メモ
• フェーズ 5D 市場コンテキストレイヤーの設計・契約検証メモ
• フェーズ 5D 市場コンテキストの実装ノート
• フェーズ 5D 市場コンテキストの管理下検証計画
• フェーズ 5D 市場コンテキストの管理下検証レポート
• フェーズ 5D 市場コンテキストの本番稼働準備完了承認
• フェーズ 5E 次の機能選定メモ
• フェーズ 5E 起動／配布準備の設計メモ
• フェーズ 5E 運用担当者向けスモークテスト手順書
• フェーズ 5E 起動リリースチェックリスト
• フェーズ 5E ディレクトリ／マーケットプレイスのメタデータ準備状況
• フェーズ 5E 管理下でのローカルクライアント検証レポート
• フェーズ 5E ローカル Stdio 起動準備完了承認
• フェーズ 5F x402 リレーアーキテクチャメモ
• フェーズ 5F x402 契約検証計画
• フェーズ 5F x402 契約検証レポート
• フェーズ 5F x402 リレー実装設計メモ
• フェーズ 5F x402 チャレンジリレーのモック実装ノート
• フェーズ 5F x402 モック検証レポート
• フェーズ 5F x402 公開チャレンジリレー接続設計メモ
• フェーズ 5F x402 公開モック接続の実装ノート
• フェーズ 5F x402 公開モック接続の検証レポート
• フェーズ 5F x402 ライブ環境でのキー不要チャレンジリレー計画
• フェーズ 5F x402 ライブ環境でのキー不要チャレンジ実装ノート
• フェーズ 5F x402 ライブ環境でのキー不要チャレンジリレー検証レポート
• フェーズ 5F x402 ライブチャレンジの契約不整合診断
• フェーズ 5F x402 API チャレンジ契約確認
• フェーズ 5F x402 v2 バリデーター調整の実装ノート
• フェーズ 5F x402 ライブチャレンジ再検証レポート
• フェーズ 5F x402 価値ポリシーの不一致調査
• フェーズ 5F x402 最終レスポンスエンベロープ調整の実装ノート
• フェーズ 5F x402 最終レスポンスエンベロープのライブ再検証レポート
• フェーズ 5F x402 終了とロードマップ引き継ぎメモ
• パッケージ成果物とインストール検証アーキテクチャ
• パッケージ実行時依存関係契約の修正
• パッケージの識別情報とライセンスに関する決定記録
• パッケージメタデータとクローズド成果物許可リストの実装
• オフラインパッケージと成果物コンテンツの検証レポート
• B-5 POSIX インストール済み Bin の修正メモ
• クロスプラットフォームのパッケージインストール／Stdio 検証レポート
• パッケージドキュメント更新と最終検証レポート
• パッケージ準備完了の締めくくりと公開決定の引き継ぎ
• パッケージ公開・配布の決定アーキテクチャ
• パッケージ公開プラットフォームの準備状況検証
• パッケージ公開アカウントと名前の準備状況レポート
• パッケージ公開組織の準備完了に関する締めくくり
• パッケージ公開の実装決定
• パッケージ公開設定の実装ノート