Suprsonic Mcp

suprsonic-mcp

Suprsonic 用の MCP サーバーです。1 つの接続で、あらゆる AI エージェントに数十種類の機能を提供します。

クイックスタート

インストール不要で、ホスト型サーバーに接続できます。

• URL：https://suprsonic.ai/v1/mcp（Streamable HTTP）
• ヘッダー：Authorization: Bearer omk_your_key（または、クライアントやゲートウェイが独自のサインイン用に Authorization を使用する場合は x-api-key: omk_your_key）

または、ご自身のマシンでサーバーを実行できます。

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

API キーは suprsonic.ai/app/api で取得できます。どちらも同じツールを同じ料金で利用できます。ツールの一覧表示にキーは不要です。有効なキーを使わずに呼び出すと、API 独自のエラーが返され、キーの取得先が示されます。

パッケージ名は suprsonic-mcp です。以前の README では @suprsonic/mcp と記載していましたが、この npm スコープは無関係の会社に属しているため、絶対にインストールしないでください。

ホスト型サーバー

Claude Code

claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omk_your_key"

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "suprsonic": {
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer omk_your_key"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します（VS Code でキーを一度入力すると、シークレットとして保存されます）。

{
  "inputs": [
    { "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk_...)", "password": true }
  ],
  "servers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:suprsonic-key}"
      }
    }
  }
}

Claude API（MCP コネクター）

ベータ版ヘッダー anthropic-beta: mcp-client-2025-11-20 を送信し、Messages リクエストに追加します。

{
  "mcp_servers": [
    { "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorization_token": "omk_your_key" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "suprsonic" }
  ]
}

OpenAI Responses API

リクエストの tools に追加します。

{
  "type": "mcp",
  "server_label": "suprsonic",
  "server_url": "https://suprsonic.ai/v1/mcp",
  "authorization": "omk_your_key",
  "require_approval": "never"
}

Smithery

Suprsonic は Smithery に suprsonic として掲載されています。Smithery のツールボックスに追加し、キーを求められたら貼り付けてください。Smithery は x-api-key としてキーをホスト型サーバーに渡します。

ローカルサーバー（npx）

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "suprsonic-mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

同じ設定項目は Cursor の mcp.json でも使用できます。

独自の HTTP エンドポイント

ホスト型サーバーの代わりに、ご自身のマシンから HTTP トランスポートを提供するには、次のようにします。

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp --http --port 3100

その後、http://localhost:3100/mcp に接続します。

利用可能なツール

呼び出しが成功した場合のみクレジットが消費されます。範囲が示されている場合、選択したモードによって料金が決まります。

ツール	機能	クレジット
search	SERP、AI による統合、またはその両方でウェブを検索します	1-3
scrape	任意の URL からコンテンツを Markdown または HTML として抽出します	1-5
profiles	専門家のプロフィールを検索し、情報を充実させます	3
emails	専門家のメールアドレスを検索します	2
images	テキストプロンプトから画像を生成します	3
tts	テキストを音声に変換します	2
stt	音声をタイムスタンプ付きで文字起こしします	2
sound-generate	テキストプロンプトから効果音や短い音楽トラックを生成します（音声による読み上げではありません。音声には tts を使用してください）	4
sms	SMS または WhatsApp メッセージを送信します。デフォルトのチャネルは SMS（確実に配信）です。WhatsApp を利用するには、受信者が過去 24 時間以内にお客様のビジネス番号へメッセージを送信し、オプトインしている必要があります。	1
documents	URL またはコンテンツから構造化データを抽出します	3
companies	ドメインから企業データを充実させます	3
email-verify	メールが配信可能か、全件受信設定か、使い捨てアドレスかを確認します	1
transcribe	音声を話者分離とタイムスタンプ付きで文字起こしします	3
invoice-parse	請求書や領収書から構造化データを抽出します	3
subtitle	音声または動画から SRT/VTT 字幕を生成します	2
file-convert	ドキュメント、ウェブページ、スプレッドシート、画像を別の形式に変換します	2
bg-remove	任意の画像から背景を削除します。透過 PNG が返されます。	2
screenshot	任意のウェブページをレンダリングしてスクリーンショットを撮影します	1
code-execute	環境設定済みの環境を備えた安全なサンドボックスでコードを実行します	2
site-intel	包括的なドメイン情報を取得します：WHOIS、DNS、SSL、技術スタック、メールセキュリティ、ホスティング	1-2
research	検索、スクレイピング、エンティティ情報の拡充、引用付きレポートの統合を行う複数ステップの詳細調査です	10-35
video-info	任意の URL から動画のメタデータ、利用可能な形式、サムネイルを抽出します	1
video-download	任意の URL から動画をダウンロードし、一時的なダウンロードリンクを返します	2-3
domains	ビジネスに適したドメイン名と拡張子を検索します	1-5

レスポンス形式

すべてのツールは、統一されたレスポンスオブジェクトを返します。

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

失敗時は、success が false となり、error に詳細が含まれます（以下を参照）。

エラー処理

すべてのエラーは同じオブジェクト形式です。機能の実行に失敗すると、上記のレスポンスで success が false に設定され、クレジットは消費されず、error としてこのオブジェクトが返されます。呼び出しが拒否された場合（無効なキー、クレジット不足、レート制限）、このオブジェクトを detail に含む HTTP 401、402、または 429 が返されます。

{
  "detail": {
    "type": "https://api.o-mega.ai/errors/insufficient-credits",
    "title": "Insufficient Suprsonic API credits",
    "status": 402,
    "detail": "This call needs 2 credits and your Suprsonic account has 0 left of its 200 free credits a month, which refill on November 12. This is your Suprsonic credit balance, not a provider's.",
    "is_retriable": false,
    "error_category": "billing",
    "alternative_action": "Pro gives 2,000 credits a month, 10 times the free plan: choose it at https://suprsonic.ai/app/subscription, or wait until November 12."
  }
}

エラーカテゴリ：transient（再試行しても安全）、permanent（不正なリクエスト）、authentication（無効なキー）、billing（クレジット不足）、content_access（その URL は配信できません。ブロック、地域制限、または非公開です）。

MCP を使用する場合、AI エージェントはツールのレスポンスでエラーオブジェクト全体を受け取るため、is_retriable と retry_after_seconds に基づいて再試行するかどうかを判断し、alternative_action に記載された対応方法を伝えることができます。

すべてのパラメーターとレスポンス例を含む API リファレンス：suprsonic.ai/apis