Anleitungen

Über MCP verbinden

Waity ist ein Remote-MCP-Server mit drei schreibgeschützten Tools. Füge ihn jedem Client hinzu, der MCP über HTTP spricht.

Server-URL

URL

https://api.waity.ai/mcp

Er funktioniert ohne Key: Jede Sitzung bekommt 100 Aufrufe pro Tag. Mit Key sendest du ihn als X-Api-Key oder Authorization: Bearer.

Ein gehosteter Connector, der nur eine URL annimmt, kann den Key darin tragen: https://api.waity.ai/mcp?key=wk_…. Waity protokolliert nie Query-Strings, aber behandle diese URL wie den Key.

Zu deinem Client hinzufügen

Claude

Öffne die Einstellungen, dann „Connectors“.
Wähle „Add custom connector“.
Nenne ihn Waity, füge die URL unten ein und wähle „Add“.

https://api.waity.ai/mcp

ChatGPT

Öffne die Einstellungen, dann „Apps & Connectors“.
Schalte unter „Advanced settings“ den „Developer mode“ ein.
Erstelle einen Connector namens Waity mit der URL unten, ohne Authentifizierung.
Wähle Waity im Chat im Tools-Menü.

https://api.waity.ai/mcp

Claude Code

Führe das im Terminal aus:

claude mcp add --transport http waity https://api.waity.ai/mcp

Prüfe danach mit /mcp in Claude Code die Verbindung.

Cursor

Oder füge es in ~/.cursor/mcp.json ein:

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

VS Code

Oder führe „MCP: Add Server“ aus, wähle HTTP und füge die URL ein:

https://api.waity.ai/mcp

Oder füge es in .vscode/mcp.json ein:

{
  "servers": {
    "waity": {
      "type": "http",
      "url": "https://api.waity.ai/mcp"
    }
  }
}

Andere Clients

Füge die URL hinzu, oder dieses JSON, wenn dein Client eine Konfigurationsdatei nutzt:

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

Tools

Alle drei Tools sind schreibgeschützt und liefern Folgelinks als fertige Tool-Aufrufe; find_waits und get_wait nutzen standardmäßig die minimale Ansicht.

`find_waits`

Orte mit ihrer aktuellen Wartezeit: nahe einem Punkt, nach Name oder Ort oder nach ID.

Name	Typ	Beschreibung
`lat`	number	Latitude in decimal degrees
`lng`	number	Longitude in decimal degrees
`q`	string	A place name, city, airport code or ZIP (at most 100 characters). With lat/lng, results sort by distance.
`ids`	string[]	Up to 25 place ids, returned in this order.
`category`	er \| urgent-care \| dmv \| airport \| border[]	Only these categories. Omit for all. Aktuelle Abdeckung; siehe GET /v1/categories.
`open`	boolean	true: only places open now.
`sort`	distance \| wait \| total	distance (default with lat/lng), wait, or total (needs lat/lng).
`limit`	integer	1 to 25, default 10.
`view`	minimal \| full	minimal (default) for the essentials, full for sources, timestamps, hours and alternatives.

`get_wait`

Ein Ort: jetzt, üblich, wann es kürzer wird und Alternativen in der Nähe. Eine Gruppen-ID liefert die Schlangen darin.

Name	Typ	Beschreibung
`id`erforderlich	string	A place id from find_waits, e.g. pl_xaed7pr1f5.
`under`	number	Threshold in minutes. Defaults: er, urgent-care and border 30, dmv 20, airport 15.
`travel_min`	number	Travel time in minutes, for a leave-by time.
`date`	string	Local date YYYY-MM-DD, today to 7 days ahead, to plan a day.
`lat`	number	The user's latitude, for distances.
`lng`	number	The user's longitude, for distances.
`forecast`	boolean	With view minimal, add a compact hourly forecast [{at, value}].
`view`	minimal \| full	minimal (default) for the essentials, full for sources, timestamps, hours and alternatives.

`get_history`

Wie die Wartezeiten eines Ortes waren: stündlich, täglich oder jeder Wert. Braucht einen Schlüssel; sagt nie einen Besuch voraus.

Name	Typ	Beschreibung
`id`erforderlich	string	A place id from find_waits (one place, lane or department, not a group), e.g. pl_xaed7pr1f5.
`from`	string	Start, inclusive: a date YYYY-MM-DD (local to the place) or an ISO 8601 date-time with offset. Default: 7 days before to.
`to`	string	End, exclusive: a date YYYY-MM-DD (local to the place) or an ISO 8601 date-time with offset. A date means the end of that day. Default: now.
`granularity`	raw \| hour \| day	hour (default): hourly avg, median, p90, min, max. day: one row per local day. raw: every posted reading.
`tier`	official \| place \| agent	Which kind of source. Default: the place's displayed source.
`cursor`	string	page.next_cursor from the previous page; carries the range.
`limit`	integer	Rows per page. Caps: raw 1000, hour 336, day 366.

MCP und REST

Unbekannte Argumente werden mit invalid_parameter abgelehnt; REST ignoriert unbekannte Parameter und meldet das in diagnostics.
MCP rät nie einen Standort: Sende einen, oder eine Stadt oder PLZ.
Ein Tool-Ergebnis trägt die Antwort in structuredContent und wiederholt sie als JSON-Text für Clients, die nur Text lesen.
Ohne Key senden MCP-Clients den Header Mcp-Session-Id von selbst zurück, sodass jede Sitzung einzeln gezählt wird.

In Claude öffnen In ChatGPT öffnen

ZurückSchnellstart WeiterREST-API