Fewsats Mcp

Fewsats MCP

What is Fewsats MCP about?

Fewsats MCP integrates the Fewsats payment platform with AI agents, allowing them to check wallet balances, list available payment methods, pay offers, and retrieve payment details in a secure, programmatic way.

How to use Fewsats MCP?

1. Installation – Install the package via the recommended uv tool:

   uvx fewsats-mcp
   

   or with pip:

   pip install fewsats-mcp
   

2. Run the server – After installation, start the MCP server with the command fewsats-mcp (or uvx fewsats-mcp).
3. Configuration – Provide your Fewsats API key through the environment variable FEWSATS_API_KEY. Example for Claude Desktop:

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

4. Interact via tools – The server exposes four tools (balance, payment_methods, pay_offer, payment_info) that can be called by AI agents or scripts.

Key features of Fewsats MCP

• Balance retrieval – Quick access to the current wallet balance.
• Payment method listing – Returns all available payment options for the user.
• Offer payment – Pay a specific offer using its ID and full L402 offer payload.
• Payment details – Query detailed status of any payment by its ID.
• Easy installation – Works with both uv and standard pip.
• Environment‑based API key – Securely inject the API key without hard‑coding.

Use cases of Fewsats MCP

• Automating purchases for AI agents in e‑commerce or digital‑goods scenarios.
• Integrating payment capabilities into custom AI workflows or bots.
• Providing real‑time financial status to autonomous agents operating on a budget.
• Building SaaS platforms where AI components need to charge users or vendors.

FAQ from the Fewsats MCP

Q: Which package manager is recommended? A: uv is the recommended tool for fast, isolated installations, but pip works as well.

Q: How is the API key supplied? A: Set the FEWSATS_API_KEY environment variable before launching the server.

Q: Can I run the server on Windows? A: Yes, as long as Python and the chosen package manager (uv or pip) are installed.

Q: What format does pay_offer expect? A: An object containing offers, payment_context_token, payment_request_url, and version as defined in the L402 specification.

Q: Is there a Docker image available? A: The repository does not currently provide a Dockerfile; run the server directly via the commands above.

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