MCP 服务器

Fewsats MCP Server

一个与 Fewsats 集成的 MCP 服务器，允许 AI 代理安全地购买任何东西，通过检索余额、访问支付方式和处理支付来实现。

Tools

pay_offer

Pays an offer_id from the l402_offers. The l402_offer parameter must be a dict with this structure: { 'offers': [ { 'offer_id': 'test_offer_2', # String identifier for the offer 'amount': 1, # Numeric cost value 'currency': 'usd', # Currency code 'description': 'Test offer', # Text description 'title': 'Test Package' # Title of the package } ], 'payment_context_token': '60a8e027-8b8b-4ccf-b2b9-380ed0930283', # Payment context token 'payment_request_url': 'https://api.fewsats.com/v0/l402/payment-request', # Payment URL 'version': '0.2.2' # API version } Returns payment status response. If payment status is `needs_review` inform the user he will have to approve it at app.fewsats.com

payment_info

Retrieve the details of a payment. If payment status is `needs_review` inform the user he will have to approve it at app.fewsats.com

balance

Retrieve the balance of the user's wallet. You will rarely need to call this unless instructed by the user, or to troubleshoot payment issues. Fewsats will automatically add balance when needed.

payment_methods

Retrieve the user's payment methods. You will rarely need to call this unless instructed by the user, or to troubleshoot payment issues. Fewsats will automatically select the best payment method.

README

fewsats-mcp: 一个 Fewsats MCP 服务器

概述

这个 MCP 服务器与 Fewsats 集成，允许 AI 代理以安全的方式购买任何东西。

MCP 是

工具

balance
- 获取用户的钱包余额
- 输入: 无
- 返回: 当前钱包余额信息
payment_methods
- 获取用户的支付方式
- 输入: 无
- 返回: 可用的支付方式列表
pay_offer
- 使用 l402_offers 中指定的 ID 支付一个 offer
- 输入:
  - offer_id (string): offer 的字符串标识符
  - l402_offer (object): 包含 offer 详细信息的对象:
    - offers: 包含 ID、金额、货币、描述、标题的 offer 对象数组
    - payment_context_token: 支付上下文令牌字符串
    - payment_request_url: 支付请求的 URL
    - version: API 版本字符串
- 返回: 支付状态响应
payment_info
- 获取支付的详细信息
- 输入:
  - pid (string): 要检索信息的支付 ID
- 返回: 详细的支付信息

安装

使用 uv (推荐)

当使用 uv 时，不需要特定的安装。我们将使用 uvx 直接运行 fewsats-mcp。

uvx fewsats-mcp

使用 PIP

或者，您可以通过 pip 安装 fewsats-mcp:

pip install fewsats-mcp

安装完成后，您可以将其作为脚本运行:

fewsats-mcp

配置

与 Claude Desktop 一起使用

将其添加到您的 claude_desktop_config.json 中:

重要提示: 将 YOUR_FEWSATS_API_KEY 替换为您从 Fewsats.com 获取的 API 密钥。

"mcpServers": {
  "Fewsats Server": {
    "command": "uvx",
    "args": ["fewsats-mcp"],
    "env": {
      "FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY"
    }
  }
}