mcpField
F
fewsats-mcp: A Fewsats MCP Server

fewsats-mcp: A Fewsats MCP Server

Local
github.com/FewsatsFinance21Updated 74w ago
Repository

About fewsats-mcp: A Fewsats MCP Server

fewsats-mcp is an MCP server that integrates with Fewsats so AI agents can purchase items in a secure way. It is intended for users who want agents to complete payments, handling wallet balance and payments through the Fewsats platform.

Key features

  1. 01Retrieve wallet balance
  2. 02List available payment methods
  3. 03Pay an offer by ID
  4. 04Retrieve payment details

Use cases

  1. 01Letting an AI agent complete item purchases
  2. 02Checking wallet balance and payment records

MCP support

The project is an MCP server that exposes the balance, payment_methods, pay_offer and payment_info tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fewsats": {
      "command": "uvx",
      "args": [
        "fewsats-mcp"
      ]
    }
  }
}
Run commanduvx fewsats-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypifewsats-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.