sats4ai-mcp

AIエージェントのためのパーミッションレスな通信スーパーチャージャー。40以上のツールがビットコインLightningで支払われます。サインアップ不要、APIキー不要、KYC不要。

リモートの MCP (Model Context Protocol) サーバーであり、AIエージェントに対して、あらゆる言語でのAI電話、602言語の音声合成、119言語の翻訳、FAX、SMS、文字起こし、オーディオブック、画像生成、音楽、ドキュメント抽出などの機能を提供します。すべてLightning Networkのマイクロペイメントによる従量課金制です。

クイックセットアップ

Claude Desktop

claude_desktop_config.json に以下を追加してください：

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

Claude Code

claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp

接続を確認します：エージェントに "list the first 3 Sats4AI models" と尋ねると、list_models が呼び出され、結果が返されるはずです。自律的に請求書を支払うエージェントの場合は、LightningウォレットMCPも追加してください（エージェントウォレットによる支払いを参照）。

Cursor

Settings → MCP → Edit Config の順に進み、以下を追加します：

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

Cursorを再起動します。新しいチャットで "what Sats4AI tools are available?" と尋ねて、ツールが検出されるか確認してください。自律的な支払いを行うには、LightningウォレットMCPとペアリングしてください（エージェントウォレットによる支払いを参照）。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します（存在しない場合は作成してください）。重要: WindsurfはリモートHTTP MCPサーバーに対して url ではなく serverUrl を使用します：

{
  "mcpServers": {
    "sats4ai": {
      "serverUrl": "https://sats4ai.com/api/mcp"
    }
  }
}

Windsurfを再起動します。Sats4AIツールがCascadeのツールリストに表示されます。Cascadeには全MCP合計で100個のツール制限があるため、アクティブなセットは最小限に抑えてください。自律的な支払いを行うには、LightningウォレットMCPとペアリングしてください（エージェントウォレットによる支払いを参照）。

stdioプロキシ（レガシーMCPクライアント）

リモートHTTPサーバーをサポートしていないクライアントの場合は、同梱のstdioプロキシを使用してください：

npx sats4ai-mcp

または設定ファイルで：

{
  "mcpServers": {
    "sats4ai": {
      "command": "npx",
      "args": ["sats4ai-mcp"]
    }
  }
}

MCPクライアント全般

サーバーURLは以下の通りです：

https://sats4ai.com/api/mcp

これはリモートHTTPサーバーであり、ローカルプロセス、依存関係、インストールは不要です。

Related MCP server: PDF Reader MCP Server

利用可能なツール

AI生成

ツール	説明	価格
`image`	テキストプロンプトから画像を生成	100-200 sats
`video`	テキストプロンプトから動画を生成	50 sats/unit
`video_from_image`	静止画を動画にアニメーション化	100 sats/sec
`text`	AI言語モデルとチャット (262Kコンテキスト)	~1 sat/100文字
`translate_text`	119言語のテキスト翻訳	~1 sat/1000文字
`music`	AIボーカル付きの楽曲を生成	100 sats
`3d`	写真を3D GLBモデルに変換	350 sats

音声・スピーチ

ツール	説明	価格
`tts`	テキスト読み上げ (467種類の声、29言語)	300 sats
`transcription`	音声の文字起こし (13言語)	10 sats/分
`voice_clone`	音声サンプルから声をクローン	7,500 sats
`epub_to_audiobook`	書籍 (EPUB/PDF/TXT) をAIナレーション付きオーディオブックに変換	500+ sats

画像処理

ツール	説明	価格
`remove_background`	画像の背景を削除 (BiRefNet, SOTA)	5 sats
`upscale_image`	Real-ESRGANで画像を2倍/4倍にアップスケール	5 sats
`restore_face`	ぼやけた/損傷した顔を修復 (CodeFormer)	5 sats
`colorize_image`	白黒写真をカラー化 (DDColor, ICCV 2023)	5 sats
`deblur_image`	手ブレを除去 (NAFNet, ECCV 2022)	20 sats
`detect_nsfw`	画像の安全性を分類 (通常/示唆的/露骨)	2 sats
`detect_objects`	バウンディングボックスで物体を検出 (Grounding DINO)	5 sats
`remove_object`	説明に基づいて物体を削除 — マスク不要	15 sats
`image_edit`	AIの指示で画像を編集	動的

ビジョン・ドキュメント

ツール	説明	価格
`vision`	画像の内容を分析・説明	21 sats
`ocr`	PDFや画像からテキストを抽出	10 sats/ページ
`extract_receipt`	レシートを構造化JSONに変換	50 sats
`file_convert`	200以上のファイル形式間で変換	100 sats
`pdf_merge`	複数のPDFを1つに結合	100 sats
`convert_html_to_pdf`	HTML/MarkdownをPDFに変換	50 sats

通信

ツール	説明	価格
`send_email`	あらゆるアドレスにメールを送信	200 sats
`send_sms`	世界中にSMSを送信	動的
`place_call`	自動電話をかける	動的
`ai_call`	AI音声エージェントを派遣して双方向通話を行う	動的 (~150-250 sats/通話)
`send_fax`	世界中にFAXを送信 (PDF URLまたは入力テキスト)	500 sats (10ページ以下), 以降1ページにつき+50 sats
`receive_fax`	24時間FAX受信ウィンドウを開き、メールで配信	500 sats (+200 OCRアドオン)

ヘルパーツール

ツール	説明
`list_models`	利用可能なAIモデルと価格を閲覧
`get_model_pricing`	特定モデルの価格を取得
`create_payment`	サービス用のLightning請求書を作成
`check_payment_status`	支払いが受信されたか確認
`check_job_status`	非同期ジョブ (動画, 3D, オーディオブック) をポーリング
`get_job_result`	完了したジョブの結果を取得
`request_refund`	失敗したサービスの返金をリクエスト
`vote_on_service`	計画中のサービスに投票
`list_planned_services`	今後のサービスを確認して投票

仕組み

エージェントが list_models を呼び出し、利用可能なモデルと価格を確認
エージェントが create_payment を呼び出し、Lightning請求書を取得
エージェントのLightningウォレット（例: lightning-wallet-mcp）を介して支払い
エージェントが paymentId を指定してツールを呼び出す（例: image, text）
結果が返される — base64画像、テキスト、URLなど

APIキー不要。アカウント不要。IDに紐付くレート制限なし。ビットコインとAIのみ。

エラーハンドリングと返金

支払い後に有料ツールが失敗した場合、JSON-RPCエラーレスポンスに返金情報が含まれます：

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Image generation failed",
    "data": {
      "refund": {
        "charge_id": 12345,
        "refund_amount": 200,
        "lnurl_withdraw": "lnurl1dp68gurn8ghj7..."
      }
    }
  }
}

LNURL対応ウォレット、または lightning-wallet の claim_lnurl_withdraw ツールを使用して返金を請求してください。

エージェントウォレットによる支払い

LightningウォレットMCPサーバーとペアリングすることで、エージェントが自律的に支払いを行えるようになります：

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    },
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

エージェントは lightning-wallet を使用して sats4ai からの請求書を支払い、完全に自律的なAIツールの利用が可能になります。

L402 API

MCPなしで直接HTTP統合を行う場合は、L402 APIを使用してください：

# Step 1: Request -> get 402 + Lightning invoice
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a cat in space"}}' -i

# Step 2: Pay the invoice with any Lightning wallet

# Step 3: Re-send with proof
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -H "Authorization: L402 <macaroon>:<preimage>" \
  -d '{"input": {"prompt": "a cat in space"}}'

L402の完全なドキュメント: sats4ai.com/l402 | コード例: sats4ai-l402-examples

サービス検出

エージェント検出用の機械可読エンドポイント：

# Full service catalog with pricing, quality benchmarks, and performance metadata
GET https://sats4ai.com/.well-known/l402-services

# MCP tool catalog with latency (p50/p95), reliability, and failure modes
GET https://sats4ai.com/api/mcp/discovery

# Semantic search — find tools by capability
GET https://sats4ai.com/api/discover?q=translate

# Per-service metadata with enums and input schemas
GET https://sats4ai.com/api/l402/{service}

すべての有料ツールにはパフォーマンスメタデータ（レイテンシp50/p95、信頼性評価、既知の障害モード）が含まれており、エージェントはどのツールを呼び出し、どれくらい待機すべきかについて情報に基づいた判断を下せます。

プログラムによる利用

const { SERVER_URL, TOOLS, getClaudeConfig } = require("sats4ai-mcp");

console.log(SERVER_URL);       // "https://sats4ai.com/api/mcp"
console.log(TOOLS);            // ["image", "video", "text", ...]
console.log(getClaudeConfig()) // { mcpServers: { sats4ai: { url: "..." } } }

セキュリティ

脆弱性を見つけましたか？公開イシューを開かないでください。 sats4ai@gmail.com までメールしてください。完全な開示ポリシーと範囲については SECURITY.md を参照してください。

リンク

ウェブサイト: sats4ai.com
MCPドキュメント: sats4ai.com/mcp
L402 APIドキュメント: sats4ai.com/l402
L402コード例: github.com/cnghockey/sats4ai-l402-examples
サービス検出: sats4ai.com/.well-known/l402-services
セマンティック検索: sats4ai.com/api/discover
セキュリティポリシー: SECURITY.md

ライセンス

MIT

Sats4AI