Fewsats

by fewsats

11 stars
7.8k downloads
Not rated
GitHub Website

About

Integrates with the Fewsats payment platform to enable secure financial transactions through L402 protocol, allowing wallet balance checks, payment method retrieval, and autonomous purchasing capabilities.

Details

Author
fewsats
Repository
Fewsats/fewsats-mcp
GitHub stars
11
Downloads
7,751
Categories
Developer Tools, Other, AI, Design, API, Security, Infrastructure, Frontend

- Retrieve wallet balance via balance tool.
- List saved payment methods via payment_methods.
- Pay an L402 offer using pay_offer.
- Fetch payment details with payment_info.
- Secure purchasing for AI Agents through Fewsats.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fewsats
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 fewsats-mcp
    Environment
    • FEWSATS_API_KEY YOUR_FEWSATS_API_KEY

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add this to your claude_desktop_config.json:

Important: Replace YOUR_FEWSATS_API_KEY with the API key you obtained 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>

balance

Retrieve the balance of the user's wallet. Input: None. Returns: Current wallet balance information.

payment_methods

Retrieve the user's payment methods. Input: None. Returns: List of available payment methods.

pay_offer

Pays an offer with the specified ID from the l402_offers. Input: offer_id (string) and l402_offer (object) containing offer details. Returns: Payment status response.

payment_info

Retrieve the details of a payment. Input: pid (string) for the Payment ID. Returns: Detailed payment information.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

- Check wallet balance— Ask the assistant to retrieve your current Fewsats wallet balance usingbalance.
- View saved payment methods— List the payment methods available in your account viapayment_methods.
- Pay for an L402 offer— Complete a purchase by providing an offer ID and its details topay_offer.
- Look up a payment— Get the status and details of a past payment by its ID withpayment_info.

This MCP server integrates withFewsatsand allows AI Agents to purchase anything in a secure way.

- Retrieve the balance of the user's wallet
- Input: None
- Returns: Current wallet balance information

- Retrieve the user's payment methods
- Input: None
- Returns: List of available payment methods

- 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

- Retrieve the details of a payment
- Input:

- pid(string): Payment ID to retrieve information for

When usinguvno specific installation is needed. We will useuvxto directly runfewsats-mcp.

Alternatively you can installfewsats-mcpvia pip:

After installation, you can run it as a script using:

Add this to yourclaude_desktop_config.json:

Important: ReplaceYOUR_FEWSATS_API_KEYwith the API key you obtained fromFewsats.com.

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

Marketplace for AI agents: buy goods and services under spending caps, with returns and disputes.

AI agent commerce: buy gift cards, top up phones, and get travel eSIMs with Bitcoin, Ethereum, Solana, USDC, USDT, Litecoin, Dogecoin, and 15+ cryptos on Base, Polygon, Arbitrum, Tron, and more. No account, no CLI install, no API key — connect via MCP or let your agent pay autonomously with x402.

An MCP server enabling AI agents to pay for services using HTTP 402 requests and MCP tools.

AI agent commerce marketplace — register, list services, buy and sell capabilities with real payments via Stripe.

Agent-commerce MCP metadata and x402 payment workflows for selling AI/API products to agents.

Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.

Shop for gift cards, esims, phone topups. Pay with cards and crypto.

Give AI agents a Bitcoin wallet with Lightning Network payments

Static MCP discovery card for x402 spend-policy, paid MCP launch guidance, seller checkout repair, and agent-payment safety APIs.

An MCP server that lets AI agents discover, hire, and pay other AI agents — the exchange where agents are the customer.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.