mcpField
O
ontopo

ontopo

github.com/alexpolonskyOther3183 installsUpdated 13w ago
Repository

About ontopo

ontopo is a command-line skill for searching Israeli restaurants and checking menus and table availability. It provides booking links for manual reservation on Ontopo rather than placing bookings.

Key features

  1. 01Search restaurants by name and city
  2. 02Check availability by date and party size
  3. 03Browse venue details and menus
  4. 04Filter menu items by section and price
  5. 05Generate Ontopo booking links

Use cases

  1. 01Find restaurants in a city
  2. 02Check tables for a planned date and time
  3. 03Compare menus and prices
  4. 04Open a venue's booking page

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/alexpolonsky/agent-skill-ontopo --skill ontopo

After installing, type/ontopoin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
.clawhubignore
LICENSE
README.md
scripts/
ontopo-cli.py
tests/
test_edge_cases.sh
test_commands.sh
test_docs_conformance.py
test_envelope_fidelity.py
test_skill_selection.sh
test_url_resolution.py

Details

From the project README

Ontopo Restaurant Search

Search Israeli restaurants, check table availability, view menus, and get direct booking links on the Ontopo platform.

Disclaimer: This is an unofficial tool, not affiliated with or endorsed by Ontopo. Availability data queries APIs that power the website and may not reflect actual availability. This tool does NOT place reservations - it generates booking links for manual confirmation on Ontopo's website. Provided "as is" without warranty of any kind.

Quick Start

# Search for a restaurant
python3 {baseDir}/scripts/ontopo-cli.py search "taizu"

# Find available restaurants for tonight
python3 {baseDir}/scripts/ontopo-cli.py available tomorrow 19:00 --city tel-aviv

Commands

cities

List supported cities.

python3 {baseDir}/scripts/ontopo-cli.py cities
python3 {baseDir}/scripts/ontopo-cli.py cities --json
categories

List venue categories.

python3 {baseDir}/scripts/ontopo-cli.py categories
search

Find restaurants by name.

python3 {baseDir}/scripts/ontopo-cli.py search "taizu"
python3 {baseDir}/scripts/ontopo-cli.py search "sushi" --city tel-aviv
python3 {baseDir}/scripts/ontopo-cli.py search "taizu" --json
available

Find venues with availability for date and time. Date and time are POSITIONAL arguments.

python3 {baseDir}/scripts/ontopo-cli.py available tomorrow 19:00
python3 {baseDir}/scripts/ontopo-cli.py available tomorrow 20:00 --city tel-aviv
python3 {baseDir}/scripts/ontopo-cli.py available +3 19:00 --party-size 4
python3 {baseDir}/scripts/ontopo-cli.py available tomorrow 19:00 --safe-zone
check

Check availability at specific venue. Supports venue name or ID.

python3 {baseDir}/scripts/ontopo-cli.py check taizu tomorrow 19:00
python3 {baseDir}/scripts/ontopo-cli.py check taizu +2 20:00
python3 {baseDir}/scripts/ontopo-cli.py check 36960535 tomorrow 19:00 --party-size 4
range

Check availability across date range. Times is OPTIONAL (defaults to 19:00,20:00).

python3 {baseDir}/scripts/ontopo-cli.py range taizu tomorrow +3
python3 {baseDir}/scripts/ontopo-cli.py range 36960535 tomorrow +5 --times "18:00,19:00,20:00"
python3 {baseDir}/scripts/ontopo-cli.py range taizu +1 +7 --party-size 4
menu

View venue menu with optional filters.

python3 {baseDir}/scripts/ontopo-cli.py menu 66915792
python3 {baseDir}/scripts/ontopo-cli.py menu 66915792 --section drinks
python3 {baseDir}/scripts/ontopo-cli.py menu 66915792 --search "pasta" --max-price 100
info

Get venue details.

python3 {baseDir}/scripts/ontopo-cli.py info 36960535
python3 {baseDir}/scripts/ontopo-cli.py info 66915792 --json
url

Get booking URL for venue.

python3 {baseDir}/scripts/ontopo-cli.py url 36960535
python3 {baseDir}/scripts/ontopo-cli.py url 66915792 --locale he

Options Reference

OptionCommandsDescription
--jsonallOutput in JSON format
--localesearch, info, urlLanguage: en or he
--cityavailable, searchCity filter (tel-aviv, jerusalem, etc.)
--party-sizeavailable, check, rangeNumber of guests (default: 2)
--safe-zoneavailableFilter to venues tagged as safe zone (מרחב מוגן) on Ontopo. Alias: --mamad
--timesrangeComma-separated times (default: 19:00,20:00)
--sectionmenuFilter by menu section
--searchmenuSearch menu items by name
--min-pricemenuMinimum price filter
--max-pricemenuMaximum price filter

Date/Time Formats

Dates: YYYY-MM-DD, today, tomorrow, +N, or a weekday name like friday Times: HH:MM, HHMM, 7pm, 19:30

Supported Cities

Run cities for the full list. Common cities: tel-aviv, jerusalem, haifa, herzliya, raanana, ramat-gan, netanya, ashdod, beer-sheva, eilat, modiin, rehovot, rishon-lezion, petah-tikva, holon, kfar-saba, hod-hasharon, caesarea. Hyphenated aliases are accepted (e.g. ramat-gan → ramatgan).

Workflow Example

# 1. Search for restaurant
python3 {baseDir}/scripts/ontopo-cli.py search "taizu"
# Note the venue ID from results (e.g., 36960535)

# 2. Check availability
python3 {baseDir}/scripts/ontopo-cli.py check 36960535 tomorrow 19:00

# 3. View menu
python3 {baseDir}/scripts/ontopo-cli.py menu 36960535

# 4. Get booking link
python3 {baseDir}/scripts/ontopo-cli.py url 36960535

Notes

  • Manual booking: Generates links - complete reservation on Ontopo website
  • No API key: Queries APIs that power the website
  • Bilingual: Supports Hebrew and English
  • Real-time data: Availability fetched live from Ontopo

Comments

Markdown supported