POS.DO MCP Server

---

POS.DO は、世界各地のレストランを検索できるプラットフォームです。店名、住所、レビュー、写真、営業時間、料理の種類、近隣地域、文化的背景、時間帯別オファーを含むリアルタイムの空席状況を提供します。この MCP サーバーは、Model Context Protocol を通じて、そのカタログを AI エージェントに公開します。

このサーバーが提供するもの

• 356,780 軒のレストランを20 か国で検索できます（US、ES、IT、MX、FR、CO、DE、GB、DO、PR、AU、CA、PT、JP、BE、CH、HK、VE、NZ、PY）
• 7 言語のコンテンツ（ES、EN、IT、FR、DE、PT、CA）
• 投稿者、評価、本文、言語、写真を含む1,410 万件以上のユーザーレビュー
• 文化的背景 — Wikidata をもとに、レストランごとの近隣のモニュメント、博物館、公園、文化遺産を掲載
• Flow の時間帯別オファー — 参加レストランのオフピーク割引と、実際の空席状況
• 冪等性を備えた予約（Idempotency-Key ヘッダーを使って安全に再試行できます）

これはプロキシリポジトリです。MCP エンドポイントは https://pos.do/mcp で稼働し、EZZYPUSH SL が運営しています。サーバーをローカルにインストールする必要はありません。エージェントから URL を指定するだけで利用できます。

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "pos-do": {
      "url": "https://pos.do/mcp"
    }
  }
}

Claude Desktop を再起動します。以下の 7 つのツールを利用できるようになります。

Cursor / Cline / Continue

ほとんどの MCP クライアントでは、同じ形式のリモート HTTP サーバーエントリを使用できます。Cursor の場合：

{
  "mcp.servers": {
    "pos-do": {
      "url": "https://pos.do/mcp",
      "transport": "http"
    }
  }
}

汎用 MCP クライアント（HTTP 経由の生の JSON-RPC）

curl -sS -X POST https://pos.do/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ツール

ツール	用途	ドキュメント
search_restaurants	都市内のレストランを、料理の種類・価格・特徴で絞り込んで検索します	ドキュメント
get_restaurant_details	スラッグで指定したレストランの詳細プロフィールを取得します	ドキュメント
get_restaurant_reviews	星評価と日付で絞り込める、ページ分割されたレビューを取得します	ドキュメント
get_flow_offers	レストランの本日の時間帯別割引枠を取得します	ドキュメント
book_flow_reservation	Flow 割引枠の座席を予約します	ドキュメント
find_restaurants_near_landmark	有名なランドマークから徒歩圏内のレストランを検索します	ドキュメント
get_cultural_context_around_restaurant	レストラン近隣のモニュメント、博物館、公園を取得します（Wikidata）	ドキュメント

inputSchema を含むツールの全一覧は、/.well-known/mcp.json でリアルタイムに提供されます。

エンドポイントとトランスポート

• 本番 URL：https://pos.do/mcp
• プロトコル：MCP 2024-11-05
• トランスポート：HTTP POST（JSON-RPC 2.0）、Streamable HTTP 互換
• ディスカバリーマニフェスト：
  • https://pos.do/.well-known/mcp.json — 公式 MCP ディスカバリー（inputSchema を含む完全な tools[]）
  • https://pos.do/.well-known/webmcp.json — webmcp.link マニフェスト
  • https://pos.do/.well-known/mcp/server-card.json — Smithery 形式のサーバーカード
  • https://pos.do/mcp/manifest.json — エイリアス

認証とレート制限

サーバーはデフォルトで匿名ティアで動作します。API キーは不要です。

ティア	1 分あたり	1 日あたり
匿名（デフォルト）	IP あたり 60 リクエスト/分	IP あたり 10,000 リクエスト/日
予約試行	IP あたり 10 回/分	メールアドレスあたり 5 回/日

より高いレート制限の API キーは、ご希望に応じて提供しています。issue を作成してください。

冪等性のある予約を行うには、Idempotency-Key HTTP ヘッダーを送信してください（任意の UUID または安定したクライアント側のキー）。24 時間以内の再送では、重複を作成せず、元の予約が返されます。

対応状況とデータソース

国別の件数と出典の帰属については、docs/data-coverage.md を参照してください。

サンプル

• Python
• Node
• curl

ステータス

安定しています。現時点では後方互換性のある変更のみです。破壊的変更は CHANGELOG.md で告知し、2.x にバージョンを引き上げます。

ライセンス

Apache License 2.0 — LICENSE を参照してください。

お問い合わせ

• 問題の報告／機能のリクエスト：github.com/posdo-io/mcp-server/issues
• 運営者：EZZYPUSH SL（スペイン）
• ウェブサイト：pos.do