{
  "openapi": "3.0.3",
  "info": {
    "title": "AI Agent Store: Services for AI agents",
    "version": "1.1.0",
    "description": "Public read-only discovery. Provider access and payments happen directly with each provider."
  },
  "servers": [
    {
      "url": "https://aiagentstore.ai"
    }
  ],
  "paths": {
    "/api/agent-services": {
      "get": {
        "operationId": "findAgentServices",
        "summary": "Search services or inspect a listing by id",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "Case-insensitive name, description or capability search",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Exact category ID",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "enum": [
                "communication",
                "browsers",
                "search",
                "web-data",
                "compute",
                "integrations",
                "memory",
                "payments"
              ]
            }
          },
          {
            "name": "interface",
            "in": "query",
            "description": "Documented execution access method",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "enum": [
                "api",
                "sdk",
                "mcp",
                "cli"
              ]
            }
          },
          {
            "name": "capability",
            "in": "query",
            "description": "Exact capability tag from the catalog",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "payment",
            "in": "query",
            "description": "Billing/payment path",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "enum": [
                "provider-account",
                "x402-wallet"
              ]
            }
          },
          {
            "name": "id",
            "in": "query",
            "description": "Exact listing ID; returns one listing and ignores search filters",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tag",
            "in": "query",
            "description": "Exact capability or interface tag; combine with other filters using AND",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Single listing when id is supplied; otherwise filtered results",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/Service"
                    },
                    {
                      "type": "object",
                      "required": [
                        "products",
                        "total"
                      ],
                      "properties": {
                        "products": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Service"
                          }
                        },
                        "total": {
                          "type": "integer"
                        },
                        "schemaVersion": {
                          "type": "string"
                        },
                        "updated": {
                          "type": "string"
                        },
                        "filters": {
                          "type": "object"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters"
          },
          "404": {
            "description": "Unknown listing id"
          },
          "405": {
            "description": "Read-only endpoint"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Service": {
        "type": "object",
        "required": [
          "id",
          "name",
          "url",
          "interfaces",
          "capabilities",
          "humanSetup",
          "authentication",
          "billing",
          "agentPayments",
          "sources",
          "verifiedAt"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "docs": {
            "type": "string"
          },
          "interfaces": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "humanSetup": {
            "type": "string"
          },
          "authentication": {
            "type": "string"
          },
          "billing": {
            "type": "string"
          },
          "firstTask": {
            "type": "string"
          },
          "limitations": {
            "type": "string"
          },
          "readiness": {
            "type": "string"
          },
          "paymentMode": {
            "type": "string"
          },
          "agentPayments": {
            "type": "string"
          },
          "verifiedAt": {
            "type": "string"
          },
          "verification": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "categoryUrl": {
            "type": "string",
            "format": "uri"
          },
          "tagLinks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          },
          "siteGuide": {
            "type": "object",
            "description": "Preview of original AI Agent Store editorial integration guidance. Fetch url for the full server-rendered playbook.",
            "properties": {
              "title": {
                "type": "string"
              },
              "summary": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "contentType": {
                "type": "string"
              },
              "requiresBrowser": {
                "type": "boolean"
              },
              "includes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "basis": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}