fewsats-mcp

This repository provides a Fewsats MCP server that enables AI Agents to securely purchase items through the Fewsats platform by managing user wallets, payment methods, and processing payments using offer IDs.

15
1

fewsats-mcp: A Fewsats MCP Server

Overview

This MCP (Merchant Control Panel) server integrates with Fewsats, enabling AI Agents to securely purchase goods and services.

Tools

  1. balance: Retrieves the user's wallet balance. Input: None. Returns: Balance information.
  2. payment_methods: Retrieves the user's available payment methods. Input: None. Returns: A list of payment methods.
  3. pay_offer: Pays a specific offer identified by its ID from the l402_offers. Input: offer_id (string) and l402_offer (object) containing offer details. Returns: Payment status.
  4. payment_info: Retrieves detailed information about a specific payment using its ID. Input: pid (string). Returns: Detailed payment information.

Installation

Using uv (recommended)

Utilizing uv with uvx allows direct execution of fewsats-mcp without specific installation steps.

uvx fewsats-mcp

Using PIP

Alternatively, install fewsats-mcp via pip:

pip install fewsats-mcp

Run it as a script:

fewsats-mcp

Configuration

Usage with Claude Desktop

Add the following to your claude_desktop_config.json, replacing YOUR_FEWSATS_API_KEY with your actual API key from Fewsats.com.

<details> <summary>Using uvx</summary>
"mcpServers": {
  "Fewsats Server": {
    "command": "uvx",
    "args": ["fewsats-mcp"],
    "env": {
      "FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY"
    }
  }
}
</details>

Repository

FE
Fewsats

Fewsats/fewsats-mcp

Created

March 12, 2025

Updated

March 27, 2025

Language

Python

Category

Developer Tools