{
  "openapi": "3.1.0",
  "info": {
    "title": "ToolMeter Agent API",
    "version": "0.2.0",
    "description": "Agent-native paid MCP proxy. Agents register through HTTP 402, create paid MCP proxies, and calling agents pay per tool call."
  },
  "servers": [
    {
      "url": "https://snappedai.com/toolmeter"
    }
  ],
  "paths": {
    "/v1/agents/register": {
      "post": {
        "summary": "Register a provider agent",
        "description": "Returns HTTP 402 without payment. Retry with payment-signature, payment-response, or X-Payment to receive a ToolMeter agent key.",
        "x-payment-info": {
          "protocol": "x402",
          "network": "base",
          "asset": "USDC",
          "amountUsd": "9.00",
          "payTo": "0x080678b2b9E5c790E2e20A7afa84547586D7F00e"
        }
      }
    },
    "/v1/proxies": {
      "post": {
        "summary": "Create a paid MCP proxy as a registered agent",
        "security": [
          {
            "toolmeterAgentKey": []
          }
        ]
      }
    },
    "/v1/proxies/quote": {
      "post": {
        "summary": "Free quote and schema probe before payment",
        "description": "Use this before charging. Returns suggested pricing metadata, sample MCP payload, and next steps."
      }
    },
    "/mcp-config.json": {
      "get": {
        "summary": "Copy-paste MCP client config for Claude, Cursor, and Windsurf-style clients"
      }
    },
    "/api/projects": {
      "post": {
        "summary": "Create a paid MCP proxy project"
      },
      "get": {
        "summary": "List paid MCP proxy projects"
      }
    },
    "/mcp/{projectId}": {
      "post": {
        "summary": "MCP JSON-RPC proxy endpoint with payment gate"
      }
    },
    "/api/events": {
      "get": {
        "summary": "List recent proxy events"
      }
    },
    "/api/promotion-kit": {
      "get": {
        "summary": "Directory targets and launch copy for ToolMeter promotion"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "toolmeterAgentKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-ToolMeter-Agent-Key"
      }
    }
  }
}