MCP HubMCP Hub
Fewsats

fewsats-mcp

by: Fewsats

Fewsats MCP server

11created 12/03/2025
Visit
Fewsats

📌Overview

Purpose: The main goal of the Fewsats MCP Server is to allow AI agents to securely purchase items through integration with the Fewsats platform.

Overview: This MCP server provides a streamlined interface for managing transactions, enabling users to check wallet balances, view payment methods, and facilitate payments for offers in a secure manner.

Key Features:

  • Balance Retrieval: Allows users to check their current wallet balance effortlessly, ensuring they have the necessary funds for transactions.

  • Payment Methods Management: Users can retrieve a list of their available payment methods, simplifying the process of selecting how to complete a transaction.

  • Offer Payment Processing: Facilitates payments for specific offers by providing essential offer details, thereby enabling smooth and efficient purchases.

  • Payment Information Retrieval: Users can access detailed information about past payments using a unique payment ID, ensuring transparency and clarity in transaction history.


fewsats-mcp: A Fewsats MCP Server

Overview

This MCP server integrates with Fewsats and allows AI Agents to purchase anything securely.

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)

No specific installation is needed when using uv. Use uvx to directly run fewsats-mcp:

uvx fewsats-mcp

Using PIP

Alternatively, install fewsats-mcp via pip:

pip install fewsats-mcp

After installation, 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
"mcpServers": {
  "Fewsats Server": {
    "command": "uvx",
    "args": ["fewsats-mcp"],
    "env": {
      "FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY"
    }
  }
}