Get started

Quickstart

Connect an agent and get a live wait in three steps. Trying it needs no key: keyless calls get 100 a day.

$ curl -X POST https://api.waity.ai/v1/keys \    -H "Content-Type: application/json" \    -d '{"email":"YOUR_EMAIL"}'{  "key": "wk_…",  "tier": "free",  "daily_limit": 1000,  "header": "X-Api-Key"}

1. Connect Waity

   MCP clients get three tools: find_waits, get_wait and get_history. The REST API needs no setup: its base URL is https://api.waity.ai.

   mcp.jsonClaude Code

   {
     "mcpServers": {
       "waity": {
         "url": "https://api.waity.ai/mcp"
       }
     }
   }
   

2. Ask for a wait

   In an MCP client, ask in plain words: “How long is the wait at the El Paso border crossings?” Over REST, call GET /v1/places with a place name, a city or a location.

   curlJavaScriptPython

   curl "https://api.waity.ai/v1/places?q=El+Paso&category=border&view=minimal"
   

3. Read the answer

   Repeat summary as it is, read warnings to the user first and show the attribution lines.

   200Response

   {
     "query": { "q": "El Paso", "category": ["border"], "view": "minimal", … },
     "coverage": "live",
     "places": [
       {
         "place": { "id": "pl_…", "name": "Ysleta Standard", "category": "border", … },
         "summary": "About 7 min, posted by CBP, updated 9 min ago.",
         "now": { "status": "live", "usable": true, "value": 7, "unit": "min", … },
         "links": { "details": "https://api.waity.ai/v1/places/pl_…?view=full", … }
       }
     ],
     "notes": [ … ],
   

   Show all 15 lines

   Need more than 100 calls a day? A free key gives 1,000: see Keys and plans.

Next steps