What is Fewsats-MCP?

Fewsats-MCP is a server that integrates with Fewsats, enabling AI agents to purchase items securely by accessing wallet balances, managing payment methods, and processing payments through the Fewsats platform.

How to use Fewsats-MCP?

1. Installation:
   • Recommended: Use uvx to run directly: uvx fewsats-mcp
   • Alternative: Install via pip (pip install fewsats-mcp) and run with fewsats-mcp
2. Configuration:
   • Set up an API key from Fewsats.com in claude_desktop_config.json for usage with Claude Desktop.

Key features of Fewsats-MCP?

• Wallet balance checks (balance)
• Payment method management (payment_methods)
• Secure offer payments (pay_offer)
• Payment information retrieval (payment_info)

Use cases of Fewsats-MCP?

1. AI agents performing secure financial transactions
2. Automated payments in applications requiring Fewsats integration
3. Wallet management for AI-driven applications

FAQ from Fewsats-MCP?

• What is MCP?: MCP stands for Machine Communication Protocol, facilitating secure interactions between AI agents and payment services.
• Is Fewsats-MCP free to use?: Yes, but a Fewsats API key is required for access.
• Can it handle multiple payment methods?: Yes, it retrieves and manages available payment methods via the payment_methods tool.

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.

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