# BrainyPOS

BrainyPOS is a restaurant POS and direct ordering platform in the United Arab Emirates.
Its public menus come only from BrainyPOS data and restaurants that explicitly opt in to
listing their menus for AI assistants. Listing is off by default. No scraping is used.

## Public menu feeds

- Search: https://pos.brainy.ae/api/v1/agent/restaurants
  Optional filters: q, emirate, area, cuisine, dish.
- Restaurant and live menu: https://pos.brainy.ae/api/v1/agent/restaurants/{restaurant_id}
- Schema.org Restaurant and Menu JSON-LD: https://pos.brainy.ae/api/v1/agent/restaurants/{restaurant_id}/menu.jsonld
- UAE Agent Feed v1 (JSONL, all opted-in restaurants): https://pos.brainy.ae/api/v1/agent/uae-agent-feed.jsonl
- UAE Agent Feed v1 (JSONL, one restaurant): https://pos.brainy.ae/api/v1/agent/restaurants/{restaurant_id}/uae-agent-feed.jsonl

The schema is brainypos-agent-feed/0. Feeds include restaurant information, AED prices,
availability, modifiers, permission and freshness timestamps, and an order_url.
Unlisted restaurants return 404. Demo restaurants are excluded from search; a permitted
demo menu can be fetched directly for testing and is marked as demo.

## Read-only MCP

Streamable HTTP endpoint: https://pos.brainy.ae/api/mcp

Tools:
- search_restaurants(query?, emirate?, area?, cuisine?, dish?, limit?): find opted-in restaurants.
- get_restaurant_menu(restaurant_id): read a restaurant's complete public menu.
- find_dishes(query, emirate?, area?, limit?): search dishes across published restaurants.

Search limits are at most 20 results. Feed and MCP are public, require no authentication,
and are rate limited by client IP. They do not call an AI model.

## Ordering and permission

These interfaces only read menus; they cannot place or change orders. Send customers to
the returned order_url (https://pos.brainy.ae/storefront/{restaurant_id}) to order.
Respect availability and the feed's generated_at and updated_at values. Menus may change
or be withdrawn when a restaurant revokes permission. Use only allergen and dietary
information explicitly provided by the restaurant; do not infer missing information.