Overview
fewsats-mcp is an MCP server that integrates with Fewsats to enable AI agents to purchase items in a secure manner. It exposes a compact set of tools for wallet and payment management: balance to retrieve the user's wallet balance; payment_methods to retrieve available methods; pay_offer to execute an offer by providing an offer_id and an l402_offer object containing offers (each with id, amount, currency, description, title), a payment_context_token, a payment_request_url, and a version; and payment_info to fetch detailed information for a given pid. The server is designed for easy integration and can be run with uvx (recommended) or installed via pip and executed as a script. Configuration supports environment-based API keys, demonstrated by an example claude_desktop_config.json configuration using FEWSATS_API_KEY. The MCP server provides secure flows for AI agents to select offers, initiate payments, and retrieve status or details, enabling automated purchasing while keeping payment data structured and traceable.
Features
Balance retrieval
Retrieve the balance of the user's wallet.
Payment methods retrieval
Retrieve the user's payment methods.
Pay offer
Process a payment for a specified offer_id using an l402_offer object that includes offers, payment_context_token, payment_request_url, and version.
Payment info retrieval
Retrieve detailed information for a given payment ID (pid).
Who Is This For?
- AI agents:Enable AI agents to securely purchase items through FEWSATS MCP server.
- Developers:Integrate FEWSATS MCP server into AI workflows and applications seamlessly.




