Fewsats MCP

fewsats_balance

Retrieve the balance of the user's wallet. You will rarely need to call this unless instructed by the user, or to troubleshoot payment issues. Fewsats will automatically add balance when needed.

fewsats_pay_offer

Pays an offer_id from the l402_offers. The l402_offer parameter must be a dict with this structure: { 'offers': [ { 'id': 'test_offer_2', # String identifier for the offer 'amount': 1, # Numeric cost value 'currency': 'usd', # Currency code 'description': 'Test offer', # Text description 'title': 'Test Package' # Title of the package } ], 'payment_context_token': '60a8e027-8b8b-4ccf-b2b9-380ed0930283', # Payment context token 'payment_request_url': 'https://api.fewsats.com/v0/l402/payment-request', # Payment URL 'version': '0.2.2' # API version } Returns payment status response. If payment status is `needs_review` inform the user he will have to approve it at app.fewsats.com

fewsats_billing_info

Retrieve the user's address and billing information. Returns billing details including name, address, and other relevant information. This information can also be used as shipping address for purchases.

fewsats_payment_info

Retrieve the details of a payment. If payment status is `needs_review` inform the user he will have to approve it at app.fewsats.com

fewsats_payment_methods

Retrieve the user's payment methods. You will rarely need to call this unless instructed by the user, or to troubleshoot payment issues. Fewsats will automatically select the best payment method.

fewsats_create_x402_payment_header

Creates a payment header for the X402 protocol. The chain is base-sepolia or base The x402 payload must be a dict with this structure: { "accepts": [ { "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", "description": "Payment for GET https://proxy402.com/7Yhuf2O3zs", "extra": { "name": "USDC", "version": "2" }, "maxAmountRequired": "10", "maxTimeoutSeconds": 300, "mimeType": "", "network": "base-sepolia", "payTo": "0xbA5Ae80f48E0C74878c1a362D69c27c2135Aa594", "resource": "https://proxy402.com/7Yhuf2O3zs", "scheme": "exact" } ], "error": "X-PAYMENT header is required", "x402Version": 1 } Returns a dict with the payment_header field that must be set in X-PAYMENT header in a x402 http request.