{
 "openapi": "3.1.0",
 "info": {
  "title": "TentRentalHQ public directory data",
  "version": "1.0.0",
  "description": "Read-only static JSON for US luxury and event tent rental companies, wedding-metro hubs and the tent rental cost index. No authentication. CC BY 4.0, attribution TentRentalHQ. Prices are planning estimates, not quotes; numbers appear only where a company publishes them. No contact details, ratings or reviews.",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "contact": {
   "name": "TentRentalHQ",
   "url": "https://tentrentalhq.com/developers/"
  }
 },
 "servers": [
  {
   "url": "https://tentrentalhq.com"
  }
 ],
 "paths": {
  "/api/v1/index.json": {
   "get": {
    "operationId": "getIndex",
    "summary": "List all endpoints",
    "responses": {
     "200": {
      "description": "Endpoint index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/companies.json": {
   "get": {
    "operationId": "listCompanies",
    "summary": "All listed tent companies with HQ point, tent styles, services, labelled price and published delivery terms",
    "responses": {
     "200": {
      "description": "Company list",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/metros.json": {
   "get": {
    "operationId": "listMetros",
    "summary": "All wedding-metro hubs with anchor point and company counts",
    "responses": {
     "200": {
      "description": "Metro index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/metros/{metro}.json": {
   "get": {
    "operationId": "getMetro",
    "summary": "Companies based in or near one metro, ranked by straight-line distance, plus its cost-index rows",
    "parameters": [
     {
      "name": "metro",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "new-york-city",
        "hamptons",
        "hudson-valley",
        "boston",
        "newport-rhode-island",
        "philadelphia",
        "washington-dc",
        "charleston",
        "nashville",
        "atlanta",
        "charlotte",
        "raleigh-durham",
        "miami-palm-beach",
        "orlando",
        "tampa-sarasota",
        "austin",
        "dallas-fort-worth",
        "houston",
        "denver",
        "phoenix-scottsdale",
        "los-angeles",
        "san-diego",
        "san-francisco-napa",
        "seattle",
        "chicago"
       ]
      },
      "description": "Metro slug from metros.json, e.g. denver"
     }
    ],
    "responses": {
     "200": {
      "description": "Metro detail",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Unknown metro slug"
     }
    }
   }
  },
  "/api/v1/cost-index.json": {
   "get": {
    "operationId": "getCostIndex",
    "summary": "Tent rental cost index: published tent prices with source links (same rows as the CSV)",
    "responses": {
     "200": {
      "description": "Cost index",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/mcp": {
   "post": {
    "operationId": "mcp",
    "summary": "Remote MCP server (JSON-RPC 2.0, Streamable HTTP, stateless). Tools: search_companies, get_cost_index. Read-only, no auth, 60 requests/minute/IP.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "JSON-RPC response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "202": {
      "description": "Notification accepted"
     },
     "429": {
      "description": "Rate limited"
     }
    }
   }
  }
 }
}