Fewsats

Fewsats MCP server

python

21

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run a focused MCP server that connects to Fewsats to securely manage wallet balances, payment methods, and offers-based purchases for AI Agents. It exposes simple, concrete actions you can call from your MCP client to check funds, view payment methods, complete offers, and inspect payments.

How to use

You interact with the MCP server to perform four core actions: view your wallet balance, retrieve available payment methods, pay an offer by its ID, and fetch detailed information about a payment. Use these actions in your MCP client to coordinate purchases securely and track payment status in real time.

How to install

Prerequisites: ensure you have a modern runtime available for running MCP servers. You will either run the server via the uvx tool or install the package with Python’s pip.

Install via uvx (recommended)

uvx fewsats-mcp

Install via Python package manager (pip)

pip install fewsats-mcp

After installation, start the server using the provided CLI:

fewsats-mcp

Configuration for use with Claude Desktop

Set your API key to connect to Fewsats when configuring the MCP client that will run the server.

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

Available tools

balance

Retrieve the balance of the user's wallet. Returns current wallet balance information.

payment_methods

Retrieve the user's available payment methods.

pay_offer

Pay an offer by ID from l402_offers using the provided offer details and payment context.

payment_info

Retrieve detailed information for a specific payment by its ID.