Sugra API MCP Server

Sugra API MCP Server とは？

Sugra API MCP Server は Sugra API 公式のホスト型 MCP エンドポイントで、AI エージェントが金融、マクロ、エンティティ（KYB と制裁）、ネットワーク、ニュース、地球、リサーチの各データにまたがる 1,600 以上のエンドポイントを発見して呼び出せます。

Sugra API は 195 の一次ソースから 36 の領域を集約し、統一されたレスポンス形式で提供します。対象は AI エージェント、フィンテックアプリ、リサーチデスク、社内ダッシュボードです。ホスト型の Sugra MCP サーバーは Anthropic の Connectors Directory と OpenAI Plugins Directory に掲載されており、ローカルの stdio パッケージ sugra-api-mcp も PyPI で公開されています。

Sugra API MCP Server の使い方

Sugra アカウントが必要です（Free プランはクレジットカード不要）。ディスカバリーは公開されていますが、ツールの呼び出しには認証が必要です。ブラウザで OAuth サインインするか、Sugra API キーを使って Authorization: Bearer を送ります。MCP の呼び出しは API の直接呼び出しと同じ 1 日のリクエスト枠を消費します。

MCP エンドポイントは https://mcp.sugra.ai/mcp です（サーバー名 sugra-api）。

Claude Code

OAuth の場合（/mcp を実行してサインイン）：

claude mcp add --transport http sugra https://mcp.sugra.ai/mcp

API キーの場合（Sugra のドキュメントと同じ）：

claude mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $SUGRA_API_KEY"

Claude Code に claude.ai アカウントでサインインしていて、Connectors Directory から Sugra を接続済みなら、すでに /mcp に表示されます。

Claude Desktop と claude.ai

Connectors Directory から Sugra を追加するか、Customize → Connectors → Add custom connector を選んで URL を貼り付け、Sugra アカウントでサインインします。

Cursor

{
  "mcpServers": {
    "sugra": {
      "url": "https://mcp.sugra.ai/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "sugra": {
      "type": "http",
      "url": "https://mcp.sugra.ai/mcp"
    }
  }
}

Codex CLI 向けには、ドキュメントで codex mcp add sugra --url https://mcp.sugra.ai/mcp --bearer-token-env-var SUGRA_API_KEY が案内されています。

Sugra API MCP Server の主な機能

• 幅広いカバレッジ：株式、オプション、暗号資産、コモディティ、為替、ファンダメンタルズ。中央銀行、統計機関、貿易。KYB、制裁、PEP シグナル、LEI/VAT の解決。IP、ASN、BGP、RPKI、Tor。厳選ニュースと GDELT。気象、気候、エネルギー、衛星データ。arXiv、NBER、Crossref。
• カタログ駆動のツール：エージェントは同梱カタログをローカルで検索し、operation_id でエンドポイントを呼び出すので、1 つのサーバーで API 全体にアクセスできます。
• エージェント向けヒント：エンドポイントの説明に処理時間の区分、同時実行の上限、バルク課金が含まれ、タイムアウトや並列数を見積もれます。
• ホスト版限定の合成ツール：エンティティ解決、スナップショット、時系列を 1 回の呼び出しで取得できます。
• コンプライアンスに配慮したスクリーニング：制裁チェックの結果はコンプライアンス上の判断ではなく、免責事項付きのスクリーニングシグナル（clear、review、hit）として返されます。
• 全プランで同じデータ：Free（$0、1 日 50 リクエスト）、Personal（月 $9、1 日 1,000 件の照会）、Dev（月 $25、1 日 5,000 件）、Pro（月 $59、1 日 50,000 件）で、機能制限はありません。

Sugra API MCP Server のツール

プローブでは 11 個のツールが返されました。

• ディスカバリー（同梱カタログを読むだけで API は呼ばない）：search_endpoints、describe_endpoint、list_toolsets、list_sources。describe_endpoint はパラメーター、JSON ボディの POST 用 request_body_schema、agent_hints を返します。
• データ呼び出し：call_endpoint は ID でオペレーションを呼び出し（バルクエンドポイントはボディの項目ごとに 1 リクエストを課金）、fetch_data は検索と呼び出しを 1 往復にまとめて自然言語のクエリに対応します。
• エンティティとコンプライアンス：sugra_entity_screen は個人名や組織名を制裁データと照合し、sugra_entity_lookup は LEI（GLEIF 経由）や EU の VAT 番号（VIES 経由）から KYB 情報をまとめて返します。
• 合成エージェントツール（ホスト版のみ）：resolve_entity はティッカー、企業、指標、コイン、通貨ペアを正規のエンティティに変換し、get_snapshot は company_snapshot や macro_calendar などの名前付きレシピを実行し、get_timeseries は範囲を限った価格、マクロ、ETF フローの系列を返します。

Sugra API MCP Server のユースケース

• 市場の質問：「Apple の現在の株価と企業スナップショットを表示して、過去 1 年の価格推移をグラフにして」
• マクロ調査：「最新の米国 CPI はいくつ？マクロカレンダー上の次の発表はいつ？」
• 取引先チェック：「このサプライヤー名を制裁リストと照合して、LEI レコードも調べて」
• オプション分析：「VIX の期間構造を取得して、コンタンゴかバックワーデーションか教えて」
• ネットワーク情報：「この IP アドレスの ASN と RPKI の状態を調べて」

Sugra API MCP Server のトラブルシューティング

• ツール呼び出しで missing_bearer_token や 401 になる：ディスカバリーは認証不要ですが、呼び出しには OAuth サインインか API キー付きの Authorization: Bearer が必要です。
• HTTP 429：プランの 1 日の上限を超えました。レスポンスに Retry-After ヘッダーが付きます。超過料金はかかりません。
• upstream_timeout：「slow」や「heavy」のエンドポイントは上流がコールド状態だと遅くなることがあり、1 回の再試行で成功することが多いです。
• Claude に Sugra の接続が 2 つある：カスタムコネクターを追加した後にディレクトリからも追加した場合は、カスタムの方を削除してください。