Fewsats MCP is a Model Context Protocol (MCP) server whose goal is to integrate Fewsats, enabling AI agents to purchase anything in a secure manner.
Purpose: To serve as a bridge between AI agents and Fewsats payment/wallet capabilities, enabling agents to invoke tools through the MCP protocol to perform operations such as balance inquiries, payment method inquiries, offer payments, and payment information inquiries.
Main capabilities (tools):
- balance: Get the balance of the user's wallet. Input: none. Returns: current wallet balance information.
- payment_methods: Get the user's payment methods. Input: none. Returns: a list of available payment methods.
- pay_offer: Pay the specified ID offer from l402_offers. Input: offer_id (string, the string identifier of the offer); l402_offer (object, containing offer details: offers—an array of offer objects containing ID, amount, currency, description, title; payment_context_token—payment context token string; payment_request_url—the URL of the payment request; version—API version string). Returns: payment status response.
- payment_info: Get detailed information about a payment. Input: pid (string, the payment ID for which to query information). Returns: detailed payment information.
Usage:
- Using uv (recommended): When using uv, no specific installation is required; you can run fewsats-mcp directly with uvx.
- You can also install fewsats-mcp via pip; after installation, it can be run as a script.
- Using with Claude Desktop: Add the corresponding configuration in claude_desktop_config.json. Important: Replace YOUR_FEWSATS_API_KEY with the API key obtained from Fewsats.com.
Applicable scenarios: Scenarios that require AI agents to securely perform purchase or payment-related operations, such as querying wallet balance and payment methods, paying a specified offer, and querying payment details.
Limitations: The material does not provide other information beyond the above tools and installation/configuration instructions, such as specific supported payment channels, details of security mechanisms, fees, prices, scope of platform compatibility, etc., which are not provided for now.
