Fewsats Mcp

What is Fewsats Mcp about?

Fewsats Mcp provides a set of tools that let AI agents interact with the Fewsats platform to manage wallet balances, discover available payment methods, execute payments for offers, and retrieve payment details. It acts as a bridge between agents and the Fewsats payment ecosystem, ensuring secure and streamlined transactions.

How to use Fewsats Mcp?

1. Installation – Install via uvx (recommended) or pip:

   uvx fewsats-mcp
   # or
   pip install fewsats-mcp
   

2. Run the server – After installation, start the MCP server with the command fewsats-mcp (or through uvx as shown above).
3. Configure API key – Set the environment variable FEWSATS_API_KEY with your Fewsats API key before launching the server.
4. Invoke tools – The server exposes four tools (balance, payment_methods, pay_offer, payment_info) that can be called by AI agents or client applications.

Key Features of Fewsats Mcp

• Balance Retrieval – Quickly obtain the current wallet balance.
• Payment Method Listing – Fetch all supported payment methods for the user.
• Offer Payment – Pay a specific offer using its ID and full L402 offer payload.
• Payment Details – Retrieve comprehensive information about any payment via its payment ID.
• Simple Installation – One‑line install with uvx or standard pip.
• Environment‑Based Configuration – Securely pass the Fewsats API key via environment variables.

Use Cases of Fewsats Mcp

• AI‑Driven Shopping – Allow autonomous agents to purchase digital goods or services on behalf of users.
• Automated Billing – Integrate with subscription services that need to charge users through Fewsats.
• Financial Dashboards – Display real‑time wallet balances and transaction histories in custom dashboards.
• Payment Verification – Validate and audit payments made by AI workflows.

FAQ from the Fewsats Mcp

Q: Do I need a Fewsats account? A: Yes, an active Fewsats account and a valid API key are required.

Q: Which command should I use to run the server? A: Use fewsats-mcp after installation. If you installed with uvx, you can also run uvx fewsats-mcp.

Q: Can I use this server with other AI platforms besides Claude Desktop? A: Absolutely. The MCP server exposes a generic HTTP interface that any platform capable of calling its tools can use.

Q: How do I set the API key securely? A: Export the variable before starting the server:

export FEWSATS_API_KEY=your_key_here
fewsats-mcp

Q: What versions of Python are supported? A: The package follows the standard Python packaging guidelines and works with Python 3.8 and newer.

fewsats-mcp: A Fewsats MCP Server

Overview

This MCP server integrates with Fewsats and allows AI Agents to purchase anything in a secure way.

MCP is

Tools

1. balance

   • Retrieve the balance of the user's wallet
   • Input: None
   • Returns: Current wallet balance information

2. payment_methods

   • Retrieve the user's payment methods
   • Input: None
   • Returns: List of available payment methods

3. pay_offer

   • Pays an offer with the specified ID from the l402_offers
   • Input:
     • offer_id (string): String identifier for the offer
     • l402_offer (object): Offer details containing:
       • offers: Array of offer objects with ID, amount, currency, description, title
       • payment_context_token: Payment context token string
       • payment_request_url: URL for payment request
       • version: API version string
   • Returns: Payment status response

4. payment_info

   • Retrieve the details of a payment
   • Input:
     • pid (string): Payment ID to retrieve information for
   • Returns: Detailed payment information

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run fewsats-mcp.

uvx fewsats-mcp

Using PIP

Alternatively you can install fewsats-mcp via pip:

pip install fewsats-mcp

After installation, you can run it as a script using:

fewsats-mcp

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Important: Replace YOUR_FEWSATS_API_KEY with the API key you obtained from Fewsats.com.

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