{
  "openapi": "3.1.0",
  "info": {
    "title": "AI Setups That Work",
    "version": "2.0.0",
    "summary": "Read the free catalog of AI setups: the MCP server and the public JSON feeds.",
    "description": "Everything here is read-only and works without signing in. There are no write endpoints. POST /api/mcp also takes an optional member token (the memberToken scheme): Without an Authorization header every tool works and the VIP tools answer with a labeled demo on sample data. With Authorization: Bearer <member token>, a recognized token gives member results from the VIP tools on the input given (on sample input when none is given). A token that is not recognized, or an Authorization header that is not a Bearer token, is refused for the VIP tools: they return an error result saying the token was not recognized and do not run. The other tools still answer. Either way the HTTP status is 200."
  },
  "servers": [
    {
      "url": "https://www.aisetupsthatwork.com"
    }
  ],
  "externalDocs": {
    "description": "Point your bot here (for AI assistants)",
    "url": "https://www.aisetupsthatwork.com/for-ai/"
  },
  "paths": {
    "/api/mcp": {
      "post": {
        "operationId": "mcp",
        "summary": "MCP server (Streamable HTTP, stateless, read-only)",
        "description": "JSON-RPC 2.0 for MCP clients: initialize, ping, tools/list, tools/call. 18 tools (13 free, 5 VIP); tools/list returns them. Five VIP tools answer with a labeled demo without a member token. Send Accept: application/json, text/event-stream. Without an Authorization header every tool works and the VIP tools answer with a labeled demo on sample data. With Authorization: Bearer <member token>, a recognized token gives member results from the VIP tools on the input given (on sample input when none is given). A token that is not recognized, or an Authorization header that is not a Bearer token, is refused for the VIP tools: they return an error result saying the token was not recognized and do not run. The other tools still answer. Either way the HTTP status is 200. Tool list and descriptions: https://www.aisetupsthatwork.com/for-ai/",
        "security": [
          {},
          {
            "memberToken": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/JsonRpcMessage"
                  },
                  {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/JsonRpcMessage"
                    },
                    "maxItems": 20
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC reply, or a list of replies for a batch",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/JsonRpcMessage"
                    },
                    {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/JsonRpcMessage"
                      },
                      "maxItems": 20
                    }
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Accepted: the request held only notifications"
          },
          "400": {
            "description": "Parse error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonRpcMessage"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonRpcMessage"
                }
              }
            }
          },
          "503": {
            "description": "Catalog unavailable for a moment",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonRpcMessage"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "mcpGet",
        "summary": "Not supported: this server has no event stream",
        "responses": {
          "405": {
            "description": "Use POST",
            "headers": {
              "Allow": {
                "schema": {
                  "type": "string",
                  "const": "POST, OPTIONS"
                }
              }
            }
          }
        }
      }
    },
    "/setups.json": {
      "get": {
        "operationId": "getSetups",
        "summary": "Every setup, with its label (tested or researched), job, category, page link and the playbooks it is in.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "setups": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "count",
                    "setups"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/kits.json": {
      "get": {
        "operationId": "getPlaybooks",
        "summary": "Ordered starter paths, setups in order (the file keeps its older name).",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "kits": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "count",
                    "kits"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/tools.json": {
      "get": {
        "operationId": "getFreetools",
        "summary": "Every free tool: what it does and who it is for.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "tools": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "count",
                    "tools"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/teams.json": {
      "get": {
        "operationId": "getTeams",
        "summary": "Every team page: its roles and the setups in each role.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "teams": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "count",
                    "teams"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/new/this-week.json": {
      "get": {
        "operationId": "getNewthisweek",
        "summary": "Setups added in the last 7 days.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "setups": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "count",
                    "setups"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "memberToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Optional, POST /api/mcp only. Without an Authorization header every tool works and the VIP tools answer with a labeled demo on sample data. With Authorization: Bearer <member token>, a recognized token gives member results from the VIP tools on the input given (on sample input when none is given). A token that is not recognized, or an Authorization header that is not a Bearer token, is refused for the VIP tools: they return an error result saying the token was not recognized and do not run. The other tools still answer. Either way the HTTP status is 200."
      }
    },
    "schemas": {
      "JsonRpcMessage": {
        "type": "object",
        "properties": {
          "jsonrpc": {
            "const": "2.0"
          },
          "id": {},
          "method": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "additionalProperties": true
          },
          "result": {},
          "error": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "jsonrpc"
        ],
        "additionalProperties": true
      }
    }
  }
}
