Step 1: Initialize Connection

First, initialize the MCP connection. This establishes the protocol version and client capabilities.

curl -X POST https://sats4ai.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "my-client", "version": "1.0.0" }
  }
}'

Step 2: List Available Tools (Optional)

You can list all available tools to see what services are offered and their parameters.

curl -X POST https://sats4ai.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}'

Step 3: Create Payment

Before using a paid service, create a payment to get a Lightning invoice. Specify the tool you want to use and the model ID.

curl -X POST https://sats4ai.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_payment",
    "arguments": {
      "toolName": "generate_image",
      "modelId": 1,
      "quantity": 1
    }
  }
}'

Response:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [{
      "type": "text",
      "text": "{
        \"paymentId\": \"abc123\",
        \"lightningInvoice\": \"lnbc...<LIGHTNING_INVOICE>\",
        \"amountSats\": 50,
        \"expiresAt\": \"2024-01-01T12:00:00Z\"
      }"
    }]
  }
}

Save the paymentId and pay the lightningInvoice using any Lightning wallet.

Step 4: Pay the Lightning Invoice

Copy the lightningInvoice and pay it using any Lightning-enabled Bitcoin wallet (Phoenix, Muun, Wallet of Satoshi, etc.).

You can optionally verify the payment was received:

curl -X POST https://sats4ai.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "check_payment_status",
    "arguments": {
      "paymentId": "abc123"
    }
  }
}'

Step 5: Execute the Service

Once payment is confirmed, call the service tool with your paymentId.

curl -X POST https://sats4ai.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "generate_image",
    "arguments": {
      "paymentId": "abc123",
      "prompt": "A futuristic Bitcoin-powered robot",
      "modelId": "black-forest-labs/flux-schnell",
      "amount": 1
    }
  }
}'

Successful Response:

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"images\": [\"https://...\"]}",
    }]
  }
}