Guías
Conectar por MCP
Waity es un servidor MCP remoto con tres herramientas de solo lectura. Añádelo a cualquier cliente que hable MCP por HTTP.
URL del servidor
URL
https://api.waity.ai/mcp
Funciona sin clave: cada sesión tiene 100 llamadas al día. Con una clave, envíala como X-Api-Key o Authorization: Bearer.
Un conector alojado que solo acepta una URL puede llevar la clave en ella: https://api.waity.ai/mcp?key=wk_…. Waity nunca registra las query strings, pero trata esa URL como la clave.
Añádelo a tu cliente
Claude
- Abre Configuración y luego Conectores.
- Elige "Add custom connector".
- Llámalo Waity, pega la URL de abajo y elige "Add".
https://api.waity.ai/mcp
ChatGPT
- Abre Configuración y luego "Apps & Connectors".
- En "Advanced settings", activa "Developer mode".
- Crea un conector llamado Waity con la URL de abajo y sin autenticación.
- En un chat, elige Waity en el menú de herramientas.
https://api.waity.ai/mcp
Claude Code
Ejecuta esto en una terminal:
claude mcp add --transport http waity https://api.waity.ai/mcp
Después ejecuta /mcp en Claude Code para comprobar la conexión.
Cursor
O añádelo a ~/.cursor/mcp.json:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
VS Code
O ejecuta "MCP: Add Server", elige HTTP y pega la URL:
https://api.waity.ai/mcp
O añádelo a .vscode/mcp.json:
{
"servers": {
"waity": {
"type": "http",
"url": "https://api.waity.ai/mcp"
}
}
}
Otros clientes
Añade la URL, o este JSON si tu cliente usa un archivo de configuración:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
Herramientas
Las tres herramientas son de solo lectura y devuelven los enlaces de seguimiento como llamadas a herramientas listas para usar; find_waits y get_wait usan la vista mínima por defecto.
find_waits
Lugares con su espera actual: cerca de un punto, por nombre o lugar, o por id.
| Nombre | Tipo | Descripción |
|---|---|---|
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. Cobertura actual; consulta 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 lugar: ahora, lo habitual, cuándo debería bajar y alternativas cercanas. Un id de grupo devuelve las filas que contiene.
| Nombre | Tipo | Descripción |
|---|---|---|
idobligatorio | 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
Cómo fueron las esperas de un lugar: por hora, por día o cada lectura. Necesita una clave; nunca predice una visita.
| Nombre | Tipo | Descripción |
|---|---|---|
idobligatorio | 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 y REST
- Los argumentos desconocidos se rechazan con
invalid_parameter; REST ignora los parámetros desconocidos y lo indica en diagnostics. - MCP nunca adivina una ubicación: envía una, o una ciudad o código postal.
- Un resultado de herramienta lleva la respuesta en
structuredContenty la repite como texto JSON para los clientes que solo leen texto. - Sin clave, los clientes MCP devuelven el encabezado
Mcp-Session-Idpor su cuenta, así que cada sesión se cuenta por separado.