Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
No arguments |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
No prompts |
Resources
Contextual data attached and managed by the client
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
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. |
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. |
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 |
payment_info | Retrieve the details of a payment.
If payment status is |
billing_info | Retrieve the user's billing information. Returns billing details including name, address, and other relevant information. This information can also be used as shipping address for purchases. |
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. |