{
  "openapi": "3.1.0",
  "info": {
    "title": "Agent Payment Gate Starter",
    "version": "1.0.0",
    "description": "Schema reference for a stdio JSON-RPC payment-gate starter that emits BSC/BEP20 USDT payment metadata."
  },
  "servers": [
    {
      "url": "stdio://python3 payment_gate_server.py",
      "description": "Local stdio JSON-RPC server"
    }
  ],
  "paths": {
    "/tools/list": {
      "post": {
        "summary": "List available tools",
        "responses": {
          "200": {
            "description": "Tool list"
          }
        }
      }
    },
    "/tools/call/build_payment_required": {
      "post": {
        "summary": "Build 402-style BSC/BEP20 USDT payment metadata",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product_id": {"type": "string"},
                  "amount": {"type": "string", "default": "0.001"},
                  "recipient": {"type": "string", "default": "0xC8A094779b3560f1fA5549f73B0b35d3609d27e6"},
                  "delivery_url": {"type": "string"}
                }
              }
            }
          }
        },
        "responses": {"200": {"description": "Payment metadata"}}
      }
    },
    "/tools/call/build_transfer_uri": {
      "post": {
        "summary": "Build an EIP-681-style BSC USDT transfer URI",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {"type": "string", "default": "0.001"},
                  "recipient": {"type": "string", "default": "0xC8A094779b3560f1fA5549f73B0b35d3609d27e6"}
                }
              }
            }
          }
        },
        "responses": {"200": {"description": "Transfer URI"}}
      }
    },
    "/tools/call/get_usdt_balance": {
      "post": {
        "summary": "Read a BSC/BEP20 USDT balance",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "address": {"type": "string", "default": "0xC8A094779b3560f1fA5549f73B0b35d3609d27e6"}
                }
              }
            }
          }
        },
        "responses": {"200": {"description": "Balance data"}}
      }
    },
    "/tools/call/verify_balance_delta": {
      "post": {
        "summary": "Verify whether current balance increased by a required delta",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["baseline_balance"],
                "properties": {
                  "address": {"type": "string", "default": "0xC8A094779b3560f1fA5549f73B0b35d3609d27e6"},
                  "baseline_balance": {"type": "string"},
                  "required_delta": {"type": "string", "default": "0.001"}
                }
              }
            }
          }
        },
        "responses": {"200": {"description": "Payment verification result"}}
      }
    }
  }
}