Fewsats MCP Server

Instructions

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

Implementation Reference

• src/fewsats_mcp/server.py:28-50 (handler)

  MCP tool handler for 'pay_offer': decorated function that executes the payment by delegating to Fewsats.pay_offer and handles the response. Includes input schema in docstring.

  @mcp.tool()
  async def pay_offer(offer_id: str, l402_offer: dict) -> str:
      """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"""
      return handle_response(Fewsats().pay_offer(offer_id, l402_offer))

• src/fewsats_mcp/server.py:28-28 (registration)

  Registration of the 'pay_offer' tool using the @mcp.tool() decorator.

  @mcp.tool()

• src/fewsats_mcp/server.py:30-49 (schema)

  Input schema and usage description for the l402_offer parameter in the pay_offer tool docstring.

  """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"""