API · MCP

AI エージェントが、サービス市場について問い合わせるためのデータインフラ。

REST API と MCP サーバーは同じ中核（正規化・指数・Confidence）を呼びます。MCP は API の AI 向けアダプタで、Claude や ChatGPT などのエージェントから「日本と米国で AI Agent Development の需給差を比較して」「この数字の根拠を全部出して」と直接呼べます。返すのは gap_index = +33（需給差）まで。「だから参入すべき」は返しません。

MCP v0.1（Streamable HTTP・stateless） REST v1 読み取りのみ現在は表示例データ

Architecture

中核はひとつ。出口が三つ。

データベース・正規化・Confidence の計算は共通で、Web ダッシュボード、REST、MCP はその出口です。仕様を変えても中核ロジックが二重化しません。

marketkernel.jp                      ← 公開サイト・デモ
api.marketkernel.jp
   ├── /v1/markets, /v1/markets/{id}, /v1/markets/{id}/trend
   ├── /v1/markets/{id}/sources, /v1/markets/{id}/trace
   ├── /v1/compare, /v1/sources, /v1/metrics, /v1/ontology
   └── /mcp                          ← MCP Server（Streamable HTTP）
            ↓
       Claude / ChatGPT / Agents

Observation → Normalization → Index → Confidence   （中核・共通）

MCP にも解釈をさせない

ツールが返すのは観測事実（7つの数字、時系列、地域比較、ソース、根拠）だけです。サーバーの instructions とリソース marketkernel://policy で、参入推奨・収益予測・総合ランキングを返さないことを AI クライアントに明示します。

「Confidence 92 って何？」と聞かれた AI は、説明を捏造せずに marketkernel://methodology を読めます。監査可能性と噛み合う設計です。

表示ルールは API 応答にも適用

検索結果は常にカテゴリ名順。ランキングを返さない
volume_absolute と confidence を省略しない。confidence_low を隠さない
全応答に versions・as_of・sample・policy を含める
価格は USD 基準で保持し、price_median_jpy と fx を併記

MCP Tools · v0.1

6つのツール。欲張らない。

名前には marketkernel_ の接頭辞を付け、他の MCP サーバーと併用しても衝突しません。すべて読み取り専用（readOnlyHint）です。

Tool	役割	主な引数
`marketkernel_search_markets`	カテゴリ・キーワード検索。region 指定で最新7指標を含める	`query, region, group, min_confidence, limit, offset`
`marketkernel_get_market`	1市場・1地域の最新値	`market, region`
`marketkernel_get_market_trend`	30／90／180／365日の日次時系列と期間内変化	`market, region, period, metrics`
`marketkernel_compare_markets`	複数市場・地域の並置。2地域以上で `cross_market_gap`	`markets[], regions[], metrics[], period`
`marketkernel_get_market_sources`	その市場に刺さっている観測器（信号の種類・状態）と M 因子（ソース多重性）	`market, region`
`marketkernel_trace_market_value`	数値の根拠を生オブジェクトのハッシュまで遡る	`market, metric, date, region`

呼び出し例

marketkernel_compare_markets(
  markets=["AI_AGENT_DEVELOPMENT"],
  regions=["JP","US"],
  metrics=["demand","supply","gap","price_median","confidence"],
  period=90
)

応答（抜粋・表示例）

{
  "items": [{
    "market": "AI_AGENT_DEVELOPMENT",
    "by_region": {
      "JP": { "demand_index": 84, "supply_index": 51, "gap_index": 33,
              "price_median_usd": 780, "price_median_jpy": 124000,
              "volume_absolute": 4120, "confidence": 92 },
      "US": { "demand_index": 88, "supply_index": 62, "gap_index": 26, ... }
    },
    "cross_market_gap": { "demand_level_diff": -4, "supply_level_diff": -11,
                          "note": "事実の並置。解釈は加えない。" }
  }],
  "versions": { "index": "index_v0.3", "confidence": "confidence_model_v0.1", ... },
  "as_of": "2026-08-25", "sample": true
}

trace_market_value — 「84 はどこから出てきたか」

marketkernel_trace_market_value(
  market="AI_AGENT_DEVELOPMENT", metric="demand", date="2026-08-25"
)
→ value 84
  signals:      coconala sales_velocity_30d / coconala-requests /
                google-trends-api / stackexchange-api
  normalization: calibration_v0.2（アンカー較正）
  ontology:     DEVELOPMENT > AI > AGENT_DEVELOPMENT (ontology_v0.2)
  index:        index_v0.3
  confidence:   92 = 100 × Σ w_k · factor_k（S/M/N/T/F の内訳）
  raw_objects:  raw/coconala/2026/08/25/... sha256:8a7fbd26…
  manifest:     2026-08-25 sha256:…  → 日次チェーン・外部アンカリング

Resources

marketkernel://methodology

方法論の公式要約（Markdown）

marketkernel://policy

解釈に関する方針と引用の要件

marketkernel://ontology

市場定義の一覧

marketkernel://sources

観測ソース台帳（信号の種類・状態・確認欄）

marketkernel://metrics/{metric}

demand / supply / gap / momentum / price_median / volume_absolute / confidence の定義

marketkernel://markets/{id}

1市場の最新値（全地域）

REST v1

同じ中核を、HTTP で。

MCP と同じ関数を呼びます。すべて GET。認証は Authorization: Bearer <api_key>。

Endpoint	内容	クエリ
`GET /v1/markets`	検索（カテゴリ名順・ページング）	`q, region, group, min_confidence, limit, offset`
`GET /v1/markets/{id}`	最新値	`region`
`GET /v1/markets/{id}/trend`	時系列	`region, period, metrics`
`GET /v1/markets/{id}/sources`	観測ソースと信号	`region`
`GET /v1/markets/{id}/trace`	根拠の遡及	`metric, date, region`
`GET /v1/compare`	市場・地域の並置	`markets, regions, metrics, period`（カンマ区切り）
`GET /v1/sources`／`/v1/metrics`／`/v1/ontology`／`/v1/methodology`	台帳・定義・方法論	—

応答ヘッダ X-MK-Sample: true の間は表示例データです。エラーは { "error": "not_found" | "bad_request", "message": "…" } で、次に何をすべきかを message に含めます。

Agent License

MCP は、それ自体が商品になる。

Internal はダッシュボード、Professional はダッシュボード＋CSV、API は REST。これに Agent License → MCP を加えます。利用量は tool_calls・markets queried・snapshot depth で計測し、キー単位で記録します。

参考価格は ¥300,000/月〜（要相談）。範囲と履歴の深さで倍率がかかります。

参考価格を見る → API・MCP について問い合わせる

接続

Streamable HTTP · https://api.marketkernel.jp/mcp

Claude Desktop や各種エージェントには、リモート MCP サーバーとして URL と API キー（Bearer）を登録します。stateless・JSON 応答のため、通常の HTTP インフラでスケールします。

実データの提供開始まで、公開エンドポイントは表示例データを返します（sample: true）。