ガイド
MCP で接続する
Waity は読み取り専用のツールを 3 つ備えたリモート MCP サーバーです。HTTP 経由の MCP に対応したクライアントならどれにでも追加できます。
サーバー URL
URL
https://api.waity.ai/mcp
キーなしでも使えます:各セッションは 1 日 100 回まで。キーがある場合は X-Api-Key または Authorization: Bearer として送ります。
URL だけを受け付けるホスト型コネクタでは、キーを URL に含められます:https://api.waity.ai/mcp?key=wk_…。Waity はクエリ文字列を記録しませんが、この URL はキーと同じように扱ってください。
クライアントに追加する
Claude
- 設定を開き、「コネクタ」を選びます。
- 「カスタムコネクタを追加」を選びます。
- 名前を Waity にし、下の URL を貼り付けて「追加」を選びます。
https://api.waity.ai/mcp
ChatGPT
- 設定を開き、「Apps & Connectors」を選びます。
- 「Advanced settings」で「Developer mode」をオンにします。
- 下の URL で Waity という名前のコネクタを作成します(認証なし)。
- チャットのツールメニューから Waity を選びます。
https://api.waity.ai/mcp
Claude Code
ターミナルで次を実行します:
claude mcp add --transport http waity https://api.waity.ai/mcp
その後、Claude Code で /mcp を実行して接続を確認します。
Cursor
または ~/.cursor/mcp.json に追加:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
VS Code
または「MCP: Add Server」を実行し、HTTP を選んで URL を貼り付けます:
https://api.waity.ai/mcp
または .vscode/mcp.json に追加:
{
"servers": {
"waity": {
"type": "http",
"url": "https://api.waity.ai/mcp"
}
}
}
その他のクライアント
URL を追加するか、設定ファイルを使うクライアントではこの JSON を使います:
{
"mcpServers": {
"waity": {
"url": "https://api.waity.ai/mcp"
}
}
}
ツール
3 つのツールはすべて読み取り専用で、続きのリンクはそのまま使えるツール呼び出しとして返ります。find_waits と get_wait の既定は minimal ビューです。
find_waits
場所と現在の待ち時間:地点の周辺、名前や地名、または id で検索。
| 名前 | 型 | 説明 |
|---|---|---|
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. 現在の対応範囲。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
1 つの場所:現在、通常、短くなる時刻、近くの代わりの場所。グループ id はその中の行列を返します。
| 名前 | 型 | 説明 |
|---|---|---|
id必須 | 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
ある場所の待ち時間の記録:1 時間ごと、1 日ごと、またはすべての値。キーが必要で、予測ではありません。
| 名前 | 型 | 説明 |
|---|---|---|
id必須 | 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 と REST の違い
- 不明な引数は
invalid_parameterで拒否されます。REST は不明なパラメーターを無視し、diagnostics でそのことを伝えます。 - MCP は位置情報を推測しません:位置情報、または都市や ZIP を送ってください。
- ツールの結果は回答を
structuredContentに入れ、テキストしか読まないクライアントのために JSON テキストとしても繰り返します。 - キーなしの場合、MCP クライアントは
Mcp-Session-Idヘッダーを自動で送り返すため、セッションごとに個別にカウントされます。