English Français العربية

POS.DO MCP Server

Official registry Search and web

Discover 356K+ restaurants in 20 countries: search, reviews, cultural context, time-based offers.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http pos-do-mcp-server 'https://pos.do/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pos-do-mcp-server": {
            "type": "http",
            "url": "https://pos.do/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PosDO MCP Server
  2. What this server provides
  3. Quick start
  4. Tools
  5. Endpoint and transport
  6. Authentication and rate limits
  7. Coverage and data sources
  8. Examples
  9. Status
  10. License
  11. Contact

PosDO MCP Server

Discovery of 356K+ restaurants across 20 countries via the Model Context Protocol.



POS.DO is a discovery platform with global coverage of restaurants — names, addresses, reviews, photos, opening hours, cuisines, neighbourhoods, cultural context, and real-time availability with time-based offers. This MCP server exposes that catalogue to AI agents over the Model Context Protocol.

What this server provides

  • 356,780 restaurants in 20 countries (US, ES, IT, MX, FR, CO, DE, GB, DO, PR, AU, CA, PT, JP, BE, CH, HK, VE, NZ, PY)
  • 7 languages of content (ES, EN, IT, FR, DE, PT, CA)
  • 14.1M+ user reviews with author, rating, text, language, photos
  • Cultural context — nearby monuments, museums, parks, and heritage sites from Wikidata, per restaurant
  • Flow time-based offers — off-peak discounts at participating restaurants, with real seat availability
  • Reservation booking with idempotent semantics (safe retries via Idempotency-Key header)

This is a proxy repository. The MCP endpoint runs at https://pos.do/mcp and is operated by EZZYPUSH SL. No local installation of the server is required — agents just point at the URL.

Quick start

Claude Desktop

Add to claude_desktop_config.json:

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

Restart Claude Desktop. The 7 tools below become available.

Cursor / Cline / Continue

Most MCP clients accept a remote HTTP server entry of the same shape. For Cursor:

{
  "mcp.servers": {
    "pos-do": {
      "url": "https://pos.do/mcp",
      "transport": "http"
    }
  }
}
Generic MCP client (raw JSON-RPC over HTTP)
curl -sS -X POST https://pos.do/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

ToolPurposeDocs
search_restaurantsSearch restaurants in a city, with cuisine/price/feature filtersdocs
get_restaurant_detailsFull profile for a restaurant by slugdocs
get_restaurant_reviewsPaginated reviews with star and date filtersdocs
get_flow_offersToday's time-based discount slots for a restaurantdocs
book_flow_reservationReserve a seat at a Flow-discounted slotdocs
find_restaurants_near_landmarkRestaurants within walking distance of a famous landmarkdocs
get_cultural_context_around_restaurantMonuments, museums, parks near a restaurant (Wikidata)docs

Full tool inventory with inputSchema is served live at /.well-known/mcp.json.

Endpoint and transport

  • Production URL: https://pos.do/mcp
  • Protocol: MCP 2024-11-05
  • Transport: HTTP POST (JSON-RPC 2.0), Streamable HTTP compatible
  • Discovery manifests:
    • https://pos.do/.well-known/mcp.json — official MCP discovery (full tools[] with inputSchema)
    • https://pos.do/.well-known/webmcp.json — webmcp.link manifest
    • https://pos.do/.well-known/mcp/server-card.json — Smithery-style server card
    • https://pos.do/mcp/manifest.json — alias

Authentication and rate limits

The server runs in anonymous tier by default. No API key required.

TierPer minutePer day
Anonymous (default)60 req/min per IP10,000 req/day per IP
Reservation attempts10/min per IP5/day per email

Higher-rate API keys are available on request — open an issue.

For idempotent reservations, send an Idempotency-Key HTTP header (any UUID or stable client-side key). Replays within 24 h return the original reservation instead of creating a duplicate.

Coverage and data sources

See docs/data-coverage.md for per-country counts and source attributions.

Examples

Status

Stable. Backwards-compatible changes only at this point. Breaking changes will be announced via CHANGELOG.md and bumped to 2.x.

License

Apache License 2.0 — see LICENSE.

Contact

Frequently asked questions

What is POS.DO MCP Server?

Discover 356K+ restaurants in 20 countries: search, reviews, cultural context, time-based offers.

How do I install POS.DO MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http pos-do-mcp-server 'https://pos.do/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does POS.DO MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is POS.DO MCP Server open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains POS.DO MCP Server?

It is published by posdo-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.