balanceLABSCO SUMMARY
The agent can settle up on its own.
L402 turns a paywall into something a machine can answer: the resource returns an offer, and this pays it. What that buys you is an agent that gets past a metered API or a paid page without stopping to ask you for a card.
What it is
An MCP server for Fewsats, a wallet that lets AI agents purchase things. It pays L402 offers — the payment-required response a paywalled resource hands back — using the payment methods on your Fewsats account.
What you get
- The current balance of your Fewsats wallet
- The payment methods available on the account
- An L402 offer paid by ID, taking the full offer object — amounts, currency, description, payment context token and request URL — and returning the payment status
- The details of any payment, read back by payment ID
Requirements
A Fewsats account and an API key from fewsats.com, kept in the environment. Run it with uvx fewsats-mcp, or pip install fewsats-mcp and run it as a script. This is a spending capability: any client holding the key can pay offers, so fund the wallet with what you are prepared for it to spend and check the balance before widening access.
Setup effort
One command plus a key — uvx fewsats-mcp, then supply credentials
USE CASES
01
Knowing what the agent can afford
Read the wallet balance before letting it commit to anything.
02
Checking how the wallet is funded
Read back the payment methods on the account.
03
Getting past a paywalled resource
Pay the L402 offer the resource handed back, by its ID.
04
Confirming a payment actually went through
Read the payment details by ID rather than trusting the call's return value.
05
Reconciling what was spent
Read the balance, then pull the details of the payments behind the change.
4 tools
Listed in project docs. Your client may show a different list.
payment_methodspay_offerpayment_infoBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- uvx on PATH
- FEWSATS_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx fewsats-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"Fewsats Server": {
"command": "uvx",
"args": [
"fewsats-mcp"
],
"env": {
"FEWSATS_API_KEY": "<YOUR_FEWSATS_API_KEY>"
}
}
}
}
