Sats4AI - Bitcoin-Powered AI Tools

sats4ai-mcp

为 AI Agent 提供无需许可的通信加速器。40 多种工具，使用 Bitcoin Lightning 付费。无需注册、API 密钥或 KYC。

一个远程 MCP（Model Context Protocol） 服务，为 AI Agent 提供多种语言的 AI 电话呼叫、602 种语言的语音服务、119 种语言的翻译、传真、SMS、转录、有声书、图像生成、音乐、文档提取等功能——所有服务均按使用量通过 Lightning Network 微支付。

快速设置

Claude Desktop

将以下内容添加到 claude_desktop_config.json（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\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

验证连接：让 Agent “列出前 3 个 Sats4AI 模型”——它应调用 list_models 并返回结果。对于可自主支付账单的 Agent，还需添加 Lightning 钱包 MCP（请参阅通过 Agent 钱包付款）。

Cursor

Settings → MCP → Edit Config，然后添加：

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

重启 Cursor。在新聊天中询问 “有哪些 Sats4AI 工具可用？”，以确认工具已被发现。对于自主付款，请搭配 Lightning 钱包 MCP（请参阅通过 Agent 钱包付款）。

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json（如果文件不存在，请创建）。重要提示：Windsurf 使用 serverUrl（而不是 url）连接远程 HTTP MCP 服务：

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

重启 Windsurf。Sats4AI 工具将显示在 Cascade 工具列表中。Cascade 对所有 MCP 的工具总数限制为 100 个，因此请尽量精简启用的工具。对于自主付款，请搭配 Lightning 钱包 MCP（请参阅通过 Agent 钱包付款）。

stdio 代理（旧版 MCP 客户端）

对于不支持远程 HTTP 服务的客户端，请使用随附的 stdio 代理：

npx sats4ai-mcp

或者在配置中添加：

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

任意 MCP 客户端

服务 URL 为：

https://sats4ai.com/api/mcp

这是一个远程 HTTP 服务——无需本地进程、依赖项或安装。

它能做什么？

连接后，直接向 Agent 提出请求。以下提示词可体验完整流程——发现服务、支付 Lightning 账单并获取结果：

• “用 Sats4AI 将这段文字翻译成西班牙语——创建付款，用我的 Lightning 钱包支付账单，然后执行翻译。”
• “查一下给 +33612345678 发送 SMS 的费用，然后发送：‘您的预约已确认，时间为明天下午 3 点。’”
• “生成一张暴风雨中灯塔的图像——支付账单并给我看结果。”
• “让 AI 语音 Agent 致电 +14155551234，帮我改约牙医，然后给我通话记录。”
• “把这个 EPUB 转成有声书——创建付款，然后轮询 check_job_status，直到任务完成。”
• “移除这张图片的背景。”
• “转录这个音频文件，然后将转录文本翻译成英文。”
• “获取将这份 3 页 PDF 传真到 +4930123456 的报价，然后发送。”

可用工具

AI 生成

工具	描述	价格
image	根据文本提示词生成图像	100-200 sats
video	根据文本提示词生成视频	按分辨率约 250-400 sats/秒（768p 为 250 / 2K 为 400）
video_from_image	将静态图像制作成动态视频	按分辨率约 250-400 sats/秒（768p 为 250 / 2K 为 400）
text	与 AI 语言模型聊天（Kimi K3，1M 上下文，支持视觉）	约 1 sat/10 个字符（最佳）· 约 1 sat/1000 个字符（标准）
translate_text	在 119 种语言之间翻译文本	每 1000 个字符起价 1 sat
translate_rare_language	翻译为前沿模型尚不支持的 452 种语言——博杰普尔语、迈蒂利语、马加希语、曼尼普尔语、克丘亚语、掸语……每种语言都有经过测量的质量分数	50 sats 起
music	生成带 AI 人声的歌曲或纯音乐（结构标签，无歌词）	5 sats/秒，15-300 秒（75-1,500 sats）· 提供书面歌词另加 25
3d	将照片转换为 3D GLB 模型	1,600 sats

**翻译价格因语言而异。**目标语言决定所用引擎，因此由更强模型支持的语言，费用高于标准的每 1000 个字符 1 sat。GET /api/languages 会返回每种语言的确切价格、所用模型及测得的 chrF 分数；402 付款挑战会始终在付款前报出实际金额。

音频与语音

工具	描述	价格
tts	文本转语音（3 个等级，支持 602 种以上语言）	按字符计费，1 sat 起
transcription	语音转文本（13 种语言）	10 sats/分钟
voice_clone	根据音频样本克隆声音	7,500 sats
epub_to_audiobook	将书籍（EPUB/PDF/TXT）转换为 AI 朗读的有声书	500 sats 起
translate_epub	将整本 EPUB 翻译成另一种语言——输入 EPUB，输出 EPUB，保留标记（异步；create_payment 需要 characterCount + targetLanguage）	按目标语言所用引擎的字符费率计费，最低 50 sats

图像处理

工具	描述	价格
remove_background	移除任意图像的背景（BiRefNet，SOTA）	44 sats
upscale_image	使用 Real-ESRGAN 将图像放大 2x/4x	5 sats
restore_face	修复模糊或受损的人脸（CodeFormer）	25 sats
colorize_image	为黑白照片上色（DDColor，ICCV 2023）	5 sats
deblur_image	去除相机抖动造成的模糊（NAFNet，ECCV 2022）	110 sats
render_card	排版标题卡片（PNG/JPEG）——布局确定；你发送的文本就是最终显示的文本	5 sats
detect_nsfw	对图像安全性进行分类（正常/暗示性/露骨）	2 sats
detect_objects	使用边界框检测物体（Grounding DINO）	5 sats
remove_object	根据描述移除物体——无需蒙版	130 sats
image_edit	根据 AI 指令编辑图像	动态定价（因模型而异）——请查看 get_model_pricing

视觉与文档

工具	描述	价格
vision	分析并描述图像内容	21 sats
ocr	从 PDF 和图像中提取文本	10 sats/页
extract_receipt	将收据转换为结构化 JSON	25 sats/页
file_convert	在 200 多种文件格式之间进行转换	100 sats
pdf_merge	将多个 PDF 合并为一个	100 sats
convert_html_to_pdf	将 HTML/Markdown 转换为 PDF	50 sats
e_signature	使用键入或手绘的签名签署 PDF	1,000 sats
boardingpass_wallet	将航空公司登机牌（PDF/屏幕截图）转换为 Google Wallet 通行证	100 sats/张

通信

工具	描述	价格
send_email	向任意地址发送电子邮件	200 sats
send_sms	向全球发送短信	动态定价（因目的地而异）——create_payment 会返回确切报价
place_call	拨打自动电话	动态定价（因目的地而异）——create_payment 会返回确切报价
ai_call	派遣 AI 语音 Agent 进行双向通话	价格因目的地和通话时长而异——create_payment 会返回确切报价
open_voice_bridge	开启一通由你的 Agent 驱动的电话，一次一轮。我们负责拨号和转录，你的 Agent 负责回复。按轮次进行，而非实时通话：从被叫方说完最后一个字到你的回复开始，中间大约会经过 2 秒，再加上模型的思考时间	需预存押金，按目的地定价——create_payment 会返回确切报价
voice_bridge_say	在已接通的电话中发言：输入文本（支持 602 种语言）或使用你自己的音频。每次回复请控制在一到两句话（最多 700 个语音单位）。被叫方无法打断	已包含在押金中
poll_voice_bridge	读取被叫方说的话。传入 waitMs（最长 25000），即可在对方说完后立即获取转录文本	已包含在押金中
end_voice_bridge	挂断电话。返回最终转录文本，以及退还未使用押金时长的链接	已包含在押金中
send_fax	向全球发送传真（PDF URL 或输入文本）	500 sats（≤10 页），之后每页 +50 sats
receive_fax	开启 24 小时接收传真窗口，传真将发送至电子邮件	500 sats（+200 OCR 附加服务）

辅助工具

工具	描述
list_models	浏览可用的 AI 模型及其定价
get_model_pricing	获取特定模型的定价
create_payment	为服务创建 Lightning 发票
check_payment_status	检查是否已收到付款。传入购物车 ID 后，会显示每个项目的状态
create_cart	使用一张发票支付 2 到 10 次调用的费用（总额最多 2,000 sats）。之后每个项目都可像普通付款一样使用。未使用的项目会在约一小时后按其价格退款
check_job_status	轮询异步任务（视频、3D、有声书、EPUB 翻译）
get_job_result	获取已完成任务的结果
request_refund	为失败的服务申请退款
vote_on_service	对计划推出的服务投赞成票或反对票
list_planned_services	查看即将推出的服务并投票

工作原理

1. Agent 调用 list_models，查看可用模型及其定价
2. Agent 调用 create_payment——获取 Lightning 发票
3. 通过 Agent 的 Lightning 钱包付款（例如 lightning-wallet-mcp）
4. Agent 使用 paymentId 调用工具（例如 image、text）
5. 返回结果——base64 图像、文本、URL 等

无需 API 密钥，无需账户，也没有与身份绑定的速率限制。只需 Bitcoin 和 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 工具领取退款。

错误还会在 error.data 中附带 error_code、恢复 suggestion、example，以及在代码可重试时提供的 retry_after_seconds。同样的字段也会出现在 isError: true 的工具结果和 await_result 返回的每个 FAILED 最终结果中，因此所有路径都使用同一套字段：根据 error_code 进行分支判断，切勿依据 error 文本判断。付款生命周期代码包括：PAYMENT_NOT_FOUND（paymentId 错误）、PAYMENT_PENDING（发票尚未支付）、PAYMENT_ALREADY_USED（每笔付款仅对应一次调用）；退款失败会显示 L402_REFUND_ISSUED，并附带 refund。完整目录：GET https://sats4ai.com/api/error-codes。

通过 Agent 钱包付款

配合 Lightning 钱包 MCP 服务，让你的 Agent 自主付款：

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

Agent 使用 lightning-wallet 支付来自 sats4ai 的发票，从而完全自主地使用 AI 工具。

有些 Agent 钱包会限制每小时可发送的付款次数。create_cart 接受 2 到 10 个项目并返回一张发票，因此整个任务只需付款一次。之后，每个项目都会使用各自的 paymentId。请保留这些 ID：购物车 ID 无法运行工具。

Block Buzz

正在运行 Block Buzz 吗？它是一个开源工作区，AI Agent 在其中是正式的团队成员。Buzz Agent 是 Goose / Codex / Claude Code 子进程，而 Buzz 会继承 MCP 配置来启动它，因此无需任何针对 Buzz 的特殊设置，此服务就能在 Buzz 工作区中运行。

最简单的方式是使用 Sats4AI persona pack：它会添加一个配置好此服务和 Lightning 钱包的 @sats4ai 队友，使其能够查询价格、支付发票，并在频道中返回结果。

git clone https://github.com/cnghockey/sats4ai-buzz-pack
buzz pack validate ./sats4ai-buzz-pack

想手动配置吗？将 sats4ai（和一个钱包 MCP）添加到 Buzz 运行的任意 Agent 即可——它的配置会直接沿用。请注意，Buzz 的 .mcp.json 仅支持 stdio，因此请使用 npx sats4ai-mcp 代理形式（如上所示），而不要使用远程 url 形式。

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 端点支持标准 L402 协议，因此 lnget（Lightning Labs 自家的 L402 客户端）会自动完成付款。将其连接到你的 Lightning 节点，然后调用端点：

lnget -X POST -d '{"text": "Hello", "targetLanguage": "Spanish"}' \
  --content-type application/json --max-cost 50 \
  https://sats4ai.com/api/l402/translate-text
# Fetches the 402, pays the invoice, retries, prints the result.

完整的 L402 文档：sats4ai.com/l402 | 代码示例：sats4ai-l402-examples

服务发现

用于 Agent 发现的机器可读端点：

# 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、可靠性评级、已知故障模式），让 Agent 能够明智地决定调用哪些工具以及等待多久。

编程式用法

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: "..." } } }

安全

发现了漏洞？请勿公开提交 issue。 请发送电子邮件至 [email protected]。完整的漏洞披露政策和范围请参见 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