Guias

Conectar via MCP

O Waity é um servidor MCP remoto com três ferramentas somente leitura. Adicione-o a qualquer cliente que fale MCP via HTTP.

URL do servidor

URL

https://api.waity.ai/mcp

Funciona sem chave: cada sessão tem 100 chamadas por dia. Com chave, envie-a como X-Api-Key ou Authorization: Bearer.

Um conector hospedado que aceita só uma URL pode levar a chave nela: https://api.waity.ai/mcp?key=wk_…. O Waity nunca registra query strings, mas trate essa URL como a chave.

Adicione ao seu cliente

Claude

Abra Configurações e depois Conectores.
Escolha "Add custom connector".
Dê o nome Waity, cole a URL abaixo e escolha "Add".

https://api.waity.ai/mcp

ChatGPT

Abra Configurações e depois "Apps & Connectors".
Em "Advanced settings", ative o "Developer mode".
Crie um conector chamado Waity com a URL abaixo e sem autenticação.
Em um chat, escolha o Waity no menu de ferramentas.

https://api.waity.ai/mcp

Claude Code

Execute isto em um terminal:

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

Depois execute /mcp no Claude Code para verificar a conexão.

Cursor

Ou adicione em ~/.cursor/mcp.json:

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

VS Code

Ou execute "MCP: Add Server", escolha HTTP e cole a URL:

https://api.waity.ai/mcp

Ou adicione em .vscode/mcp.json:

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

Outros clientes

Adicione a URL, ou este JSON se seu cliente usar um arquivo de configuração:

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

Ferramentas

As três ferramentas são somente leitura e retornam links de acompanhamento como chamadas de ferramenta prontas; find_waits e get_wait usam a visão mínima por padrão.

`find_waits`

Lugares com a espera atual: perto de um ponto, por nome ou local, ou por id.

Nome	Tipo	Descrição
`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 atual; veja 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`

Um lugar: agora, o habitual, quando deve diminuir e alternativas próximas. Um id de grupo retorna as filas dentro dele.

Nome	Tipo	Descrição
`id`obrigatório	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`

Como foram as esperas de um lugar: por hora, por dia ou cada leitura. Precisa de uma chave; nunca prevê uma visita.

Nome	Tipo	Descrição
`id`obrigatório	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 e REST

Argumentos desconhecidos são rejeitados com invalid_parameter; o REST ignora parâmetros desconhecidos e avisa em diagnostics.
O MCP nunca adivinha a localização: envie uma, ou uma cidade ou ZIP.
O resultado de uma ferramenta traz a resposta em structuredContent e a repete como texto JSON para clientes que só leem texto.
Sem chave, os clientes MCP devolvem o header Mcp-Session-Id por conta própria, então cada sessão é contada separadamente.

Abrir no Claude Abrir no ChatGPT

AnteriorInício rápido PróximaAPI REST