API · MCP

開発者向け API と MCP

ウェブサイトと同じツールを、スクリプト、アプリ、AI エージェント(Claude、ChatGPT、Cursor)で。キーもクレジット残高もひとつです。

1. キー

アカウントの「API と MCP」でキーを作成し、Authorization ヘッダーで送信します。キーは一度しか表示されません。コードではなくシークレットに保管してください。

Authorization: Bearer x2_live_…

2. ジョブを開始

ファイルを POST(multipart)します。コンバーターは /api/jobs、AI ツールは /api/ai/jobs。ツールのオプションは opts フィールドに JSON で指定します。

3. 結果を取得

done または failed になるまでステータスをポーリングし、同じキーでファイルをダウンロードします。ファイルは 2 時間保存されます。

cURL

curl -s -H "Authorization: Bearer $X2_KEY" \
  -F "[email protected]" \
  "https://x2tool.com/api/jobs?tool=pdf-to-word"
# → {"id":"7f3c…","status":"queued"}

curl -s "https://x2tool.com/api/jobs/7f3c…"
# → {"status":"done","files":[{"name":"report.docx","url":"/api/files/7f3c…/report.docx"}]}

curl -s -H "Authorization: Bearer $X2_KEY" -o report.docx \
  "https://x2tool.com/api/files/7f3c…/report.docx"

Python

import os, time, requests

KEY = os.environ["X2_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

# ШІ / AI tool with options (no file)
job = requests.post("https://x2tool.com/api/ai/jobs?tool=translate-text", headers=H,
                    data={"opts": '{"text": "Hello!", "to": "uk"}'}).json()
while True:
    st = requests.get(f"https://x2tool.com/api/ai/jobs/{job['id']}").json()
    if st["status"] in ("done", "failed"): break
    time.sleep(1)
for f in st["files"]:
    open(f["name"], "wb").write(requests.get("https://x2tool.com" + f["url"], headers=H).content)

AI エージェント向け MCP

X2TOOL を MCP サーバーとして接続すると、エージェントが適切なツールを見つけて実行し、結果へのリンクを返します。

https://x2tool.com/mcp · Streamable HTTP · Bearer

Claude Desktop / Cursor — mcp.json

{
  "mcpServers": {
    "x2tool": {
      "type": "http",
      "url": "https://x2tool.com/mcp",
      "headers": { "Authorization": "Bearer x2_live_…" }
    }
  }
}

Claude Code

claude mcp add --transport http x2tool https://x2tool.com/mcp \
  --header "Authorization: Bearer x2_live_…"

MCP ツール

search_tools
タスクやファイル形式でツールを検索
run_tool
実行:file_url または file_base64、オプションを指定し、結果を待機
get_job
長時間ジョブのステータス
get_balance
プランと残りクレジット

制限とプラン

  • API と MCP は Business プランに含まれます。Free と Pro では 1 日 20 回までお試しで呼び出せます。
  • コンバーターはクレジット不要です。AI ツールは成功した実行 1 回につき 1 クレジットからです。
  • ファイルサイズはプランの上限に従います。MCP は 100 MB までのファイルを受け付けます。
  • 結果は 2 時間利用でき、その後完全に削除されます。

エラーコード

401 bad_api_key
キーが誤っているか、失効しています
402 no_credits
クレジットが不足しています。チャージしてください
403 api_plan_required
本日のお試し回数を使い切りました。Business が必要です
413 plan_file_too_large
ファイルがプランの上限を超えています
429 rate_limited / daily_limit
リクエストが多すぎます。しばらくお待ちください
415 unsupported_type
このツールはこの形式に対応していません

API で利用できるツール

893 個のサーバーツールと AI ツール。slug はツールページのアドレスです。

すべてのツール

アイデアはありますか?

欲しいツールや改善してほしい点はありますか?すべてのメッセージに目を通しています。