← ekiten.jp

INDIVIDUAL MCP TOOL

search_shops

エキテンのネット予約に対応した店舗を検索する。店舗名・住所・大ジャンル・小ジャンルに加え、日時・人数の大まかな条件で絞り込み可能。取得した shopId を予約在庫状況取得・予約登録ツール(get_availability)で使用する。keyword / address / prefecture / city / prefectureCode / cityCode / largeGenreId / smallGenreId のいずれか1つ以上を必ず指定すること。日時・人数条件は任意。メニュー・スタッフ・禁煙喫煙等の詳細条件は search_shops では絞り込めないため、候補店舗ごとに予約在庫状況取得・予約登録ツール(get_availability)を使用すること。

ekiten.jpnone authenticationAvailability not checked

LIVE ENDPOINT

https://eapi.ekiten.jp/mcp/reservation

No auth detected

Connect to this endpoint to inspect the live schema for search_shops and invoke it with your own arguments.

Indexed input schema

{}

Risk classification

Inferred read-only · medium confidence · heuristic, not a guarantee.

  • No write-capable action terms were found; this is not proof that invocation has no side effects.

Parent server

ekiten.jp

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.ekiten-reservation]
url = "https://eapi.ekiten.jp/mcp/reservation"
enabled = true
Claude Code

.mcp.json

{
  "mcpServers": {
    "ekiten-reservation": {
      "type": "http",
      "url": "https://eapi.ekiten.jp/mcp/reservation"
    }
  }
}
Claude Desktop

Settings → Connectors → Add custom connector

Name: ekiten-reservation
Remote MCP URL: https://eapi.ekiten.jp/mcp/reservation

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "ekiten-reservation": {
      "url": "https://eapi.ekiten.jp/mcp/reservation"
    }
  }
}
Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code
{
  "servers": {
    "ekiten-reservation": {
      "type": "http",
      "url": "https://eapi.ekiten.jp/mcp/reservation"
    }
  }
}
Generic MCP

Client-specific MCP configuration

{
  "name": "ekiten-reservation",
  "transport": "streamable-http",
  "url": "https://eapi.ekiten.jp/mcp/reservation"
}
MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

Related tools

  • get_genres — エキテンの大ジャンル・小ジャンルの全件一覧を取得する。ジャンルはキーワード検索ではなく一覧から選ぶ方式。引数は不要。AIはユーザーの入力(「美容」「グルメ」等)とレスポンス内の largeGenreName / smallGenreName を照合し、該当する largeGenreId / smallGenreId を選択すること。曖昧または複数該当する場合はユーザーに確認すること。取得したIDを店舗検索ツールに渡す。【次のステップ】選択した largeGenreId / smallGenreId を使って search_shops を呼び出す。
  • logout — 現在のセッションのログイン状態を解除する。
  • cancel_reservation — ログイン済みユーザーの予約をキャンセルする。未ログインユーザーはキャンセル不可(ログインしていない場合は start_login を呼び、返されたloginUrlをユーザーに提示してログインを案内すること)。キャンセルする reservationNo は create_reservation(予約登録ツール)のレスポンスで取得した値を使用する。実行前に必ずユーザーにキャンセル対象の予約内容を確認し、最終確認を求めること。
  • create_reservation — エキテンのネット予約を登録する。事前に get_availability(予約在庫状況取得ツール)で店舗の予約可能な空き枠(reservationType・空席スロット・メニュー・スタッフ・クーポン・人数設定等)を取得してから使用すること。tableUnit(グルメ向け)かつ headcountBreakdownEnabled: true(内訳あり)の場合、headcountBreakdown の合計人数は get_availability の該当 slots[].
  • start_login — ネット予約のログインを開始する。返されたloginUrlをユーザーに提示し、ブラウザで開いてログインを完了するよう案内すること。このURLは短命かつ一度きりの使い切りであり、他人と共有しないようユーザーに必ず注意喚起すること。ログイン完了後、AIは同じチャット内で予約操作(cancel_reservation等)を再実行してよい。
  • get_availability — 指定した店舗の予約可能な空き枠を、日時・人数・メニュー・スタッフ・禁煙喫煙・クーポン等の条件で取得する。事前に search_shops(店舗検索ツール)で取得した shopId を指定すること。予約方式(timeUnit/tableUnit)によって返却項目が異なる。フィルタ条件を指定した場合、条件に合致しない空き枠は除外(canReserve: falseに更新)され、選択できないメニュー・スタッフ・クーポンには isSelectable: false と unselectableReason(選択不可の理由コード)が付与される。AIがユーザーに予約条件を提示し、条件を確定するための情報として使用する。【reservationType による create_reservation への影響】取得した reservationType によって次ステップ create_reservation の必須パラメータが変わる。timeUnit(全ジャンル向け):headcount不要・staffId指定可・smokingPreference不要。tableUnit(グルメ向け):headcountBreakdownEnabled が false なら headcount 必須、true なら headcountBreakdown(内訳)必須。smokingSetting が separate(分煙)なら smokingPreference 必須。staffId はトルツメ。menuSelectionRequired が true の場合は menuId 必須。【人数上限の確認】tableUnit(グルメ向け)で headcountBreakdownEnabled が true の場合、各 slots[] の headcountBreakdownMax が日時・禁煙喫煙・選択済みメニューの限定数・連結可能なテーブルの最大定員数を反映した合計人数の動的な上限値。ユーザーに人数を提示・確認する際はこの値を上限として使用すること。【選択不可の判定に含まれる要素】menuId・staffId を指定した場合、限定条件(利用可能時間・曜日・日・1日の限定数)に加えて、メニューの同時対応可能件数・スタッフの同時担当可能件数が該当時間枠で上限に達していないかも判定される。staffId・c