Daepak Market Intelligence

Daepak MCP

あらゆる MCP 対応エンジンで利用できる市場インテリジェンスツールです。Claude Code、Claude Desktop、自作のエージェントに対応しています。価格、指標、レベル、ポジショニング、韓国市場、米国株、オプション、バックテスト、マクロ（FRED）、SEC と OpenDART のファンダメンタルズ、独自の取引ジャーナルを扱えます。108 個のツールを提供しており、製品のアナリスト自身が使用するものと同じです。

サーバー自体は何も定義しません。GET /v1/tools からカタログを取得するため、お使いのキーで呼び出しを許可されているツールだけが正確に表示され、製品とのずれも生じません。

クイックスタート

インストール不要 — リモートサーバー（推奨）

同じツールを OAuth 2.1 対応の https://daepak.com/mcp（Streamable HTTP）で提供しています。ブラウザーで一度サインインするだけで、コピーするキーはありません。

claude mcp add --transport http daepak https://daepak.com/mcp

次に、Claude Code 内で /mcp → daepak → Authenticate を選択します。Claude.ai のカスタムコネクター（URL を貼り付け）や ChatGPT の開発者モードでも、同様に利用できます。Codex CLI の場合：

[mcp_servers.daepak]
url = "https://daepak.com/mcp"

OAuth ではなくキーを使いたい場合（サーバー、CI）は、ヘッダーとして送信します。

claude mcp add --transport http daepak https://daepak.com/mcp --header "Authorization: Bearer dpk_live_…"

ローカル（stdio）

claude mcp add daepak -e DAEPAK_API_KEY=dpk_live_… -- uvx daepak-mcp

または、自分でインストールできます。

pip install daepak-mcp

daepak.com のプロフィールにある Keys ページでキーを取得してください。無料プランには月 2 000 クレジットが含まれており、ひと晩かけて何かを作るのに十分です。

設定

変数	デフォルト	用途
DAEPAK_API_KEY	—	ご利用のキー（dpk_live_…）。必須です。
DAEPAK_BASE_URL	https://daepak.com	別の環境を指定します
DAEPAK_TIMEOUT	120	呼び出しごとのタイムアウト秒数

これ以外は読み込みません。特に、ユーザー名を指定する設定はありません。アカウントはキーから特定されるため、リクエストで他人になりすますことはできません。

利用できるもの

カタログはキーのスコープでフィルタリングされるため、呼び出せないツールが表示されることはありません。

scope	tools	what it opens
read:market	88	価格、ローソク足、指標、レベル、スコア、ナラティブ、デリバティブ、注文板、清算、オプション、米国株、韓国市場、ファンダメンタルズ（OpenDART、SEC）、マクロ（FRED）、バックテスト
read:personal	9	保有ポジション、ポートフォリオ、取引ジャーナル、カタリスト、メモリー、バックグラウンドタスク
write:personal	11	同じ記録への書き込み
agent:chat	—	完全なアナリスト回答（ストリーミングまたは一括）

ジャーナルの読み取りが許可されていても、書き込みが許可されるわけではありません。書き込みには別のスコープが必要です。

暗号資産 — get_price、get_price_history、get_levels（サポート／レジスタンス、フィボナッチ、 ATR — 描画ではなく計算）、get_indicators、get_score、get_regime、get_derivatives、 get_orderbook、get_liquidations、get_fear_greed

韓国 — get_kimchi_premium（Upbit とグローバル市場の価格差。資産要因と為替要因に分解）、韓国銘柄、Upbit の新規上場銘柄

米国株 — get_stock_quote、get_stock_history、get_stock_levels、 get_stock_holders（機関投資家とインサイダー）、get_us_gap_stats、get_us_movers、 get_us_halts、get_us_insiders

一次情報源のファンダメンタルズ — get_kr_financials（KRX 上場銘柄の K-IFRS、OpenDART）、get_us_financials（SEC EDGAR の米国会計基準および IFRS の会計年度別データ、最大 20 年分）、compare_financials（韓国企業と米国企業を同一スキーマで比較、FRED レートで USD 換算）、 get_kr_insiders、screen_kr（RS パーセンタイルと外国人保有フローを含む KRX 全銘柄）、 get_kr_rs、list_kr_etfs、backtest_kr_portfolio（KOSPI との比較）

マクロ — get_macro_snapshot（FF 金利、米国 2 年債／10 年債とイールドカーブ、広義のドル、 USD/KRW、VIX、前年比 CPI、失業率、韓国の翌日物金利）、get_macro_series（任意の FRED ID の時系列データ）。各行に stale_days が含まれます。韓国の CPI がないのは意図的です — FRED の系列は 2023 年に終了しました。

オプション — get_iv_metrics、get_options_positioning、get_option_structure（ペイオフと グリークス）、get_options_backtest

検証 — get_backtest、get_signal_outcomes、get_hit_rate、get_score_history

任意のトークン — resolve_token、get_token_market、get_token_onchain、 get_token_holders。ウォッチリスト外のトークンにも対応します。

リサーチ — search_news（収集済みコーパスを対象とする RAG）、search_narratives、 fetch_url、web_search

エージェント

HTTP 経由で、製品内で回答するアナリストと同じエージェントを利用できます。チャットで使える機能はすべて備えています。

POST /v1/agent/stream	サーバー送信イベント — 文章が生成されるそばから届きます
POST /v1/agent/messages	完全な回答を一度のレスポンスで取得
GET /v1/agent/resume/{id}	すでに実行中の生成に再接続
POST /v1/agent/cancel/{id}	生成を停止
GET /v1/agent/conversations	会話一覧。メッセージを取得するには /{id} を指定

curl -N -X POST https://daepak.com/v1/agent/stream \
     -H "Authorization: Bearer dpk_live_…" -H "Content-Type: application/json" \
     -d '{"message": "How does BTC look right now?", "mode": "mentor"}'

会話メモリー。 最初のイベントには conversation_id が含まれます。これを渡し直すと、会話のコンテキストが引き継がれます。

画像。 images には、チャットの添付ファイルと同じ形式のデータ URL を指定できます。エージェントはチャートやスクリーンショットを読み取ります。

メンターモード。 mode: "mentor" を指定すると、結論だけでなく、分析に至った過程も説明します。

⚠️ 接続が切れても、データは失われません。 生成はバックグラウンドで続行され、回答は会話に保存されます。resume を使えば、見逃した内容を再生できます。最初のイベントに含まれる conversation_id を保存してください。再接続先はそこです。

⚠️ suggest（追加の質問）は done の後に届きます。done の時点で読み取りを停止するクライアントには届きません。これは意図した順序です。追加の質問を計算する前に、スピナーを停止できるようにしています。

クレジット

各ツールの価格はカタログに記載されているため、実行前に一連の処理の予算を立てられます。 価格は推測ではなく、本番環境でツールを計測して決めています。

tier	内容	クレジット
当社のデータベース	価格、指標、レベル、ローソク足、ナラティブ	1
外部呼び出し	株式、トークン、オプション、オンチェーン	5
埋め込み、サンドボックス	ニュース検索、コード実行	20

まだ価格が設定されていないツールの料金は5クレジットで、1クレジットではありません。価格未設定のツールは、見落としがあるか、処理が重いかのどちらかです。無料で提供するより、どちらの場合も多めに請求するほうが安全です。

curl -H "Authorization: Bearer dpk_live_…" https://daepak.com/v1/usage

月間クレジットを使い切ると、次の2つの方法を提示する402が返されます。上位プランへの変更、または月初の更新を待つ方法です。超過分の請求はありません。予期しない請求書を送るくらいなら、リクエストを拒否します。

APIを直接使う

MCP サーバーは、シンプルなREST APIを薄く包んだものです。

# catalogue: schema, scope and price for every tool your key can call
curl -H "Authorization: Bearer dpk_live_…" https://daepak.com/v1/tools

# call one
curl -X POST https://daepak.com/v1/tools/get_price \
     -H "Authorization: Bearer dpk_live_…" \
     -H "Content-Type: application/json" \
     -d '{"coin": "BTC"}'

{
  "tool": "get_price",
  "credits_used": 1,
  "credits_left": 1999,
  "took_ms": 104,
  "data": { "coin": "BTC", "price": 78017.26, "change_24h": -1.2 }
}

完全なリファレンス：daepak.com/reference · OpenAPI 3.1：/v1/openapi.json（106件の操作。閲覧にキーは不要です）。

回答を正しく読み取る

データを見ると分かることのうち、誤解しやすい点をいくつか紹介します。

• ゼロではなく、ベースラインと比較してください。「方向を68％当てた」という結果も、同じタイミングでランダムに選んだ場合の結果が分からなければ意味がありません。
• **勝率は利益ではありません。**当社のデータでは、方向を68％正しく予測しても、プロフィットファクターは1.04でした。
• **観測数が30件未満のグループには、reliable=falseのフラグが付いています。**これは結論が弱いのではなく、結論が出ていないことを意味します。
• キムチプレミアムには2つの要素があります。資産のディスカウントとウォンのディスカウントです。これらを合わせて読むと誤解を招きます。また、これは予測ではなく説明です。1日以内の期間では、関連性は見つかりませんでした（646エピソード）。
• すべての回答には、データの鮮度が示されています。データが古い場合は、昨日のデータを現在のものとして提示せず、その旨を伝えてください。

トラブルシューティング

401 — キーが設定されていないか、無効化されているか、形式が正しくありません。Authorization: Bearer dpk_live_…として送信してください。

403 scope_required — キーに必要なスコープがありません。レスポンスに不足しているスコープが示されます。

400 user_id_not_accepted — リクエスト本文にuser_idが含まれていました。アカウントはキーから特定されるため、このフィールドは明示的に拒否されます。無視して何も返さないのではなく、コピーしたサンプルの誤りがはっきり分かるようにするためです。

404 conversation_not_found — その会話は別のアカウントに属しています。

429 — プランの分あたりの上限を超えています。分あたりの上限はサービスを保護し、月間上限は予算を保護します。

CERTIFICATE_VERIFY_FAILED — certifiをインストールせずにソースから実行しています。ファイルではなくパッケージをインストールしてください。この依存関係はまさにそのためにあります。

エラーメッセージはデフォルトで英語です。韓国語またはロシア語にするには、X-Lang: koまたはruを送信してください。

リンク

• daepak.com — 製品
• 開発者向けドキュメント — ライブリクエストテスター付き
• GitHub · PyPI

ライセンス

MIT