{
 "openapi": "3.1.0",
 "info": {
  "title": "ToolPassed open results",
  "version": "1.0.0",
  "description": "Static, read-only JSON of ToolPassed's hands-on test results. No key needed, CORS open. ToolPassed test results are free to reuse under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Please credit ToolPassed with a link back to https://toolpassed.com/ (or to the item's page).",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "contact": {
   "email": "hello@toolpassed.com",
   "url": "https://toolpassed.com/api/"
  }
 },
 "servers": [
  {
   "url": "https://toolpassed.com"
  }
 ],
 "paths": {
  "/api/v1/results.json": {
   "get": {
    "summary": "All tested items with per-client results",
    "operationId": "listResults",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "license": {
           "type": "string"
          },
          "generated": {
           "type": "string",
           "format": "date"
          },
          "items": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Item"
           }
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/{type}/{slug}.json": {
   "get": {
    "summary": "One item with its latest results and earlier runs",
    "operationId": "getItem",
    "parameters": [
     {
      "name": "type",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "mcp",
        "skill",
        "tool"
       ]
      }
     },
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "item": {
           "$ref": "#/components/schemas/Item"
          },
          "history": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Run"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "Not tested / unknown slug"
     }
    }
   }
  },
  "/feed.json": {
   "get": {
    "summary": "JSON Feed 1.1 of new and changed results",
    "operationId": "jsonFeed",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/feed+json": {}
      }
     }
    }
   }
  },
  "/feed.xml": {
   "get": {
    "summary": "RSS 2.0 of new and changed results",
    "operationId": "rssFeed",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/rss+xml": {}
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "Item": {
    "type": "object",
    "required": [
     "slug",
     "type",
     "name",
     "url",
     "clients"
    ],
    "properties": {
     "slug": {
      "type": "string"
     },
     "type": {
      "type": "string",
      "enum": [
       "mcp",
       "skill",
       "tool"
      ]
     },
     "name": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "repo": {
      "type": [
       "string",
       "null"
      ]
     },
     "maker": {
      "type": [
       "string",
       "null"
      ],
      "description": "GitHub owner"
     },
     "category": {
      "type": [
       "string",
       "null"
      ]
     },
     "date_tested": {
      "type": "string",
      "format": "date"
     },
     "passed_in": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "clients": {
      "type": "object",
      "additionalProperties": {
       "$ref": "#/components/schemas/Run"
      }
     },
     "api_url": {
      "type": "string",
      "format": "uri"
     }
    }
   },
   "Run": {
    "type": "object",
    "properties": {
     "result": {
      "type": "string",
      "enum": [
       "passed",
       "failed",
       "partial",
       "inconclusive"
      ]
     },
     "pass": {
      "type": "boolean"
     },
     "date_tested": {
      "type": "string",
      "format": "date"
     },
     "run_at": {
      "type": "string",
      "format": "date-time"
     },
     "client_version": {
      "type": [
       "string",
       "null"
      ]
     },
     "install": {
      "description": "MCP: the exact install command the harness ran. Skill: installed_as, invocation, source repo+commit."
     }
    }
   }
  }
 }
}