fewsats-mcp
by: Fewsats
Fewsats MCP server
📌Overview
Purpose: The main goal of the Fewsats MCP Server is to allow AI agents to securely purchase items through integration with the Fewsats platform.
Overview: This MCP server provides a streamlined interface for managing transactions, enabling users to check wallet balances, view payment methods, and facilitate payments for offers in a secure manner.
Key Features:
-
Balance Retrieval: Allows users to check their current wallet balance effortlessly, ensuring they have the necessary funds for transactions.
-
Payment Methods Management: Users can retrieve a list of their available payment methods, simplifying the process of selecting how to complete a transaction.
-
Offer Payment Processing: Facilitates payments for specific offers by providing essential offer details, thereby enabling smooth and efficient purchases.
-
Payment Information Retrieval: Users can access detailed information about past payments using a unique payment ID, ensuring transparency and clarity in transaction history.
fewsats-mcp: A Fewsats MCP Server
Overview
This MCP server integrates with Fewsats and allows AI Agents to purchase anything securely.
Tools
-
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): String identifier for the offerl402_offer
(object): Offer details containing:offers
: Array of offer objects with ID, amount, currency, description, titlepayment_context_token
: Payment context token stringpayment_request_url
: URL for payment requestversion
: API version string
- Returns: Payment status response
-
payment_info
- Retrieve the details of a payment
- Input:
pid
(string): Payment ID to retrieve information for
- Returns: Detailed payment information
Installation
Using uv (recommended)
No specific installation is needed when using uv. Use uvx
to directly run fewsats-mcp:
uvx fewsats-mcp
Using PIP
Alternatively, install fewsats-mcp via pip:
pip install fewsats-mcp
After installation, run it as a script using:
fewsats-mcp
Configuration
Usage with Claude Desktop
Add this to your claude_desktop_config.json
:
Important: Replace YOUR_FEWSATS_API_KEY
with the API key you obtained from Fewsats.com.
Using uvx
"mcpServers": {
"Fewsats Server": {
"command": "uvx",
"args": ["fewsats-mcp"],
"env": {
"FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY"
}
}
}