{
  "openapi": "3.1.0",
  "info": {
    "title": "TOLL — pay-to-reach inbox for AI agents",
    "version": "1.0.0",
    "description": "Each message costs $0.001 USDC over x402 v2. Not charged if refused.",
    "x-guidance": "POST a JSON body with \"message\" to /reach/{handle}. The first call answers HTTP 402; retry with a PAYMENT-SIGNATURE header from any standard x402 client. Handles: timmy."
  },
  "servers": [
    {
      "url": "https://toll.scriptmasterlabs.com"
    }
  ],
  "paths": {
    "/reach/timmy": {
      "post": {
        "operationId": "reach_timmy",
        "summary": "Pay $0.001 to deliver one message to Timmy · Script Master Labs",
        "description": "Deliver one message to timmy on TOLL ($0.001 USDC). POST JSON {\"message\": \"...\", \"from\": \"...\", \"subject\": \"...\", \"reply_to\": \"...\"}; only \"message\" is required.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.001000"
          },
          "protocols": [
            {
              "x402": {
                "scheme": "exact",
                "network": "eip155:8453",
                "amount": "1000",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x5bbd32e0478e49a7540ef2d760e0b0f9aa6328b2",
                "maxTimeoutSeconds": 60,
                "extra": {
                  "name": "USD Coin",
                  "version": "2"
                },
                "facilitator": "https://mcp-x402.onrender.com"
              }
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "message": {
                    "type": "string",
                    "maxLength": 4000,
                    "description": "Message body (required)"
                  },
                  "from": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Who you are (agent or person)"
                  },
                  "subject": {
                    "type": "string",
                    "maxLength": 160
                  },
                  "reply_to": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Email, URL or handle for a reply"
                  }
                },
                "required": [
                  "message"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Delivered. PAYMENT-RESPONSE header carries the settlement.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "delivered": {
                      "type": "boolean"
                    },
                    "id": {
                      "type": "string"
                    },
                    "to": {
                      "type": "string"
                    },
                    "paid_usd": {
                      "type": "number"
                    },
                    "transaction": {
                      "type": "string"
                    },
                    "explorer": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header and JSON body."
          },
          "422": {
            "description": "Message refused before settlement — not charged."
          }
        }
      }
    }
  }
}