Guides

Se connecter via MCP

Waity est un serveur MCP distant avec trois outils en lecture seule. Ajoutez-le à tout client qui parle MCP sur HTTP.

URL du serveur

URL

https://api.waity.ai/mcp

Il fonctionne sans clé : chaque session a droit à 100 appels par jour. Avec une clé, envoyez-la en X-Api-Key ou Authorization: Bearer.

Un connecteur hébergé qui n’accepte qu’une URL peut y inclure la clé : https://api.waity.ai/mcp?key=wk_…. Waity n’enregistre jamais les query strings, mais traitez cette URL comme la clé.

Ajoutez-le à votre client

Claude

Ouvrez les Paramètres, puis Connecteurs.
Choisissez « Add custom connector ».
Nommez-le Waity, collez l’URL ci-dessous et choisissez « Add ».

https://api.waity.ai/mcp

ChatGPT

Ouvrez les Paramètres, puis « Apps & Connectors ».
Dans « Advanced settings », activez « Developer mode ».
Créez un connecteur nommé Waity avec l’URL ci-dessous, sans authentification.
Dans une conversation, choisissez Waity dans le menu des outils.

https://api.waity.ai/mcp

Claude Code

Exécutez ceci dans un terminal :

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

Puis lancez /mcp dans Claude Code pour vérifier la connexion.

Cursor

Ou ajoutez-le à ~/.cursor/mcp.json :

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

VS Code

Ou lancez « MCP: Add Server », choisissez HTTP et collez l’URL :

https://api.waity.ai/mcp

Ou ajoutez-le à .vscode/mcp.json :

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

Autres clients

Ajoutez l’URL, ou ce JSON si votre client utilise un fichier de configuration :

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

Outils

Les trois outils sont en lecture seule et renvoient les liens de suivi sous forme d’appels d’outils prêts à l’emploi ; find_waits et get_wait utilisent la vue minimale par défaut.

`find_waits`

Des lieux avec leur attente actuelle : près d’un point, par nom ou lieu, ou par id.

Nom	Type	Description
`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. Couverture actuelle ; voir 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`

Un lieu : maintenant, l’habituel, quand l’attente devrait baisser et les alternatives proches. Un id de groupe renvoie les files qu’il contient.

Nom	Type	Description
`id`obligatoire	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`

Ce qu’étaient les attentes d’un lieu : par heure, par jour ou chaque relevé. Demande une clé ; ne prédit jamais une visite.

Nom	Type	Description
`id`obligatoire	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 et REST

Les arguments inconnus sont rejetés avec invalid_parameter ; REST ignore les paramètres inconnus et le signale dans diagnostics.
MCP ne devine jamais une position : envoyez-en une, ou une ville ou un code postal.
Un résultat d’outil porte la réponse dans structuredContent et la répète en texte JSON pour les clients qui ne lisent que du texte.
Sans clé, les clients MCP renvoient d’eux-mêmes l’en-tête Mcp-Session-Id, donc chaque session est comptée séparément.

Ouvrir dans Claude Ouvrir dans ChatGPT

PrécédentDémarrage rapide SuivantAPI REST