How to Use Resy restaurant search in opencode
Returns nearby restaurants matching your search, with open reservation slots for the requested date and party. Use it to discover dining options before inspecting a particular restaurant.
Prompts to try with Resy restaurant search in opencode
Copy an example into opencode, or ask in your own words.
Use Resy restaurant search to find Italian restaurants near Union Square in New York for two people tomorrow, then populate the project's restaurant comparison view with the returned names and open times.
Use Resy restaurant search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Resy restaurant search and tell me what changed since last week.
Check Resy restaurant search and summarize what you find in three bullet points.
Pull the newest data from Resy restaurant search and give me the result as a table.
How to set up Resy restaurant search in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Resy restaurant search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "resy-com/restaurants/search_venues", "input": { "day": "<day>", "latitude": -90, "longitude": -180 } }'
Then paste one of the prompts above: opencode finds Resy restaurant search on Spiral, shows the price and runs it.
Resy restaurant search providers and prices
Spiral runs Resy restaurant search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Latitude | -90 to 90 | latitude | |
| Longitude | -180 to 180 | longitude | |
| Page | 1 to 1000 | 1-based page; pass | |
| Per page | 1 to 50 | Hits per page (default 20). | |
| Radius m | 500 to 161000 | Search radius as the site takes it (default 16100, the web client's 10 miles). | |
| Party size | 1 to 20 | Number of guests (default 2). | |
| Include tock inventory | on or off | Include the Tock-hosted venues the site merges into search, as the web client does (default true); pass false for Resy-native venues only. Tock rows are flagged |
Every API field of Resy · Search venues is on its tool page: open its card above.
What can you do with Resy restaurant search in opencode?
Build a dining planner that connects Resy city records, restaurant profiles, calendar openings, and available seatings. A coding agent can bring returned data into your project and display reservation conditions beside each choice.
Plan dinners for a city break
Identify Chicago's Resy location, discover restaurants, and compare their profiles. Check calendars across the trip, inspect exact times on promising dates, and review the selected reservation's conditions.
Find a birthday dinner with date flexibility
Locate the New York dining market and find restaurants for six guests. Compare venue details, calendars, open times, and reservation requirements across several possible evenings.
Choose dinner before a show
Resolve the destination city and find restaurants near the theater. Use venue addresses, calendar openings, exact seating times, and reservation conditions to choose dinner for the performance date or an alternate night.
Build a shortlist around preferred seating
Start with San Francisco's Resy location and discover candidate restaurants. Read their profiles, find dates with openings, compare returned seating labels, and inspect the conditions for a suitable reservation.
Keep backup dinner options ready
Find alternatives near the original restaurant and compare their venue details and open times. Review the reservation requirements before replacing the first choice.
Create a personal restaurant notebook
Organize restaurant discoveries by Resy city and save venue addresses, websites, and menu links for future dining plans.
More on Resy restaurant search and opencode
Overview
Resy restaurant search in other agents
Questions about Resy restaurant search in opencode
Can opencode use Resy restaurant search?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Resy restaurant search like any built-in tool.
How much does Resy restaurant search cost in opencode?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need an Alexandria account to use Resy restaurant search in opencode?
No. Spiral runs Resy restaurant search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Resy restaurant search in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Resy restaurant search runs?
Resy restaurant search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.
What kinds of venues does Resy cover?
Resy announced a discovery catalog of more than 25,000 venues after adding Tock listings. Its coverage includes restaurants, wineries, and culinary experiences.
Does no online availability mean a restaurant is full?
No. Restaurants can hold tables back for walk-ins or in-house bookings, so Resy's online inventory does not represent every seat in the restaurant.
How far ahead are reservations published?
The booking window varies by restaurant. Resy's November 2026 guide lists Lilia at 28 days ahead at 10 a.m. and Straker's NYC at two weeks ahead at midnight.
How quickly can availability change?
Resy warns that inventory can change quickly. An opening returned during a search can disappear before you finish choosing a restaurant.
Are reservation requirements the same at every restaurant?
No. Individual reservations can carry cancellation policies or prepayment requirements, so the conditions attached to the selected seating matter.
Start using Resy restaurant search in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


