Blackbird Concierge

Blackbird activations near the diner: curated events, pop-ups and specials, active now or over about the next week. Pass the handle from birdie_start.

birdie_search_events

The diner's Blackbird tier and reward multiplier. Pass the handle from birdie_start.

birdie_status

Block another diner. This removes any friendship or request between them. Confirm with the diner first. Pass user_id when a row gave you one (birdie_friends, birdie_friend_requests), else name. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_block_diner

Book a real table from a slot that birdie_check_availability or birdie_find_reservations returned. This commits a reservation. Restate the venue, date, time and party size, and get a clear yes from the diner before you call it. Pass slot exactly as the availability row gave it. Pass as venue_id that row's venue_id, or its place_id (with the place: prefix) when it has no venue_id. Never build or change a slot. On success the result carries a confirmation_number. Pass it to birdie_modify_reservation or birdie_cancel_reservation. If the result is resy_auth_required, run birdie_connect_resy, then book again with the same slot. If it is service_timeout, the booking may or may not exist: check birdie_list_reservations before you try again. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_book_reservation

Withdraw a friend request this diner sent. Confirm with the diner first. Pass user_id when a birdie_friend_requests row gave you one, else name. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_cancel_friend_request

Cancel a reservation the diner booked through Blackbird. This really cancels the table. Take confirmation_number from a birdie_list_reservations row or a booking result, never from the diner's email. Restate the venue, date and time and get a clear yes first. A repeat cancel returns cancelled, not an error. Pass venue_id from that birdie_list_reservations row only when the result is reservation_ambiguous. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_cancel_reservation

Change an existing reservation: its date, time, party size or seating. This rebooks the table, and the old time is given up. Take confirmation_number and venue_id from a birdie_list_reservations row or a booking result. Restate the change and get a clear yes from the diner first. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_modify_reservation

Real open tables at named venues for a date, time and party size. venue_ids takes a venue's venue_id, or the place_id of a place that has no venue_id, as a Birdie row gives it. Reports slots and never holds one. A slot can be taken by the time anyone acts on it, so never tell the diner a table is theirs. Pass the handle from birdie_start.

birdie_check_availability

Connect the diner's Resy account with a one-time SMS sign-in, so a Resy venue can be booked. Start it only after birdie_book_reservation returned resy_auth_required. Call it once per step and follow the next field in each result: step "send" texts a code, step "verify" takes the code the diner gives you, and step "challenge" takes the account email and the challenge_id when Resy asks. On authenticated, book again with the same slot. Phone and email default to the diner's Blackbird profile. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_connect_resy

Create a new custom list for the diner, such as "Date Night". Do not create a list that already exists. Add to it with birdie_add_to_list instead. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_create_list

The critics, creators and guides the diner follows. This is what makes a Birdie recommendation theirs rather than generic. Each source carries a finished markdown link; cite it exactly as written. Pass the handle from birdie_start.

birdie_my_sources

Delete one of the diner's custom lists, and every place saved to it. This cannot be undone. Name the list and what it holds, and get a clear yes, before you call it. Pass list as the diner's words for it. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_delete_list

Find a real place by name in Google Places when Birdie does not know it. Returns up to 5 candidates, each with a label and an opaque place handle for birdie_add_taste_venue or birdie_resolve_venue. Confirm the right one with the diner by name and address. Pass the handle from birdie_start.

birdie_search_places

Find bookable venues with real open slots for a date, time and party size, ranked by the diner's taste. Pass venue_name for one named venue, or leave it out for an "anywhere tonight" ask. Reports slots. It never holds one, so a slot can be taken by the time anyone acts on it. Pass the handle from birdie_start.

birdie_find_reservations

Follow a content source for the diner: an Instagram or TikTok account, a Substack, a guide such as the Eater 38, or a shared Google Maps list. It shapes their future recommendations. Call it only when the diner clearly asks. Pass the source's URL. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_follow_source

Friend requests this diner received (direction=received, the default) or sent that are still outstanding (direction=sent). A sent request is never reported as declined: Blackbird does not say. Pass the handle from birdie_start.

birdie_friend_requests

Let Birdie check tables at a place from birdie_search_places that it cannot check yet, and return its venue_id. Pass that venue_id to birdie_check_availability. To answer about the place, call birdie_venue_details with its name. Pass the place handle verbatim. Call it only for a place the diner confirmed. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_resolve_venue

Everything known about one named venue: cuisine, price, neighborhood, hours, highlighted dishes, and the diner's own relationship to it. Use it when the diner names a place, including one birdie_recommend_venues did not return. Pass date, a local date such as 2026-10-24, to also read that day's hours. Pass the handle from birdie_start.

birdie_venue_details

Set or change the diner's star rating, 1 to 5, for a place they visited. A rating belongs to a visit, so they must have been there. A new rating replaces the old one. Pass location_id from a Birdie row. Leave check_in_id out at first: with several visits the result is multiple_visits, which lists each check_in_id to pick from. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_rate_visit

Rank places for an open question about where to go, using the diner's own visits, saved lists and followed sources. Takes a natural-language query. Richer is better: vibe, occasion, cuisine and meal, not keywords. Optional filters are city, neighborhoods, max_price, meal_type, require_outdoor, require_dog_friendly and exclude_visited. Pass open_at, a local time such as 2026-06-30T12:30:00, to leave out venues closed then. Rows carry the diner's signals: how many times they have been, when they last went, which followed sources covered the venue, and whether it is on one of their lists. When a row says the visit count belongs to the restaurant rather than the branch, the diner has not necessarily been to that address. Say the restaurant, not the branch. Absence from this result is never evidence a venue is absent from Blackbird. These are the closest matches to one query, not every place Birdie knows. If the diner names a venue that is missing, look it up with birdie_venue_details. Pass the handle from birdie_start.

birdie_recommend_venues

Remove a saved reservation email for a provider (opentable, resy, sevenrooms). Pass the exact saved address. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_remove_reservation_email

Remove a venue from one of the diner's lists. Pass list as the diner's words for the list, and as venue_id the venue's venue_id from a Birdie row, or its place_id for a place that has no venue_id. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_remove_from_list

Remove a place from the diner's taste profile. Pass query as the diner's words: a name and any location hint. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_remove_taste_venue

Rename one of the diner's custom lists. Pass list as the diner's words for it, and new_name. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_rename_list

Rename a source the diner follows, so it reads back as their own name for it. Pass query as the diner's words for the source, and name as the new name. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_rename_source

Add a venue to one of the diner's lists, Favorites and Want to Go included. Pass list as the diner's words for the list, and as venue_id the venue's venue_id from a Birdie row, or its place_id for a place that has no venue_id. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_add_to_list

Read back exactly what is saved about the diner's stated preferences. Pass the handle from birdie_start.

birdie_preferences

Send a friend request. The other diner sees it, so call it only after the diner has said yes to sending it. Takes the user_id a prior row gave you; there is no people search. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_send_friend_request

Save the email address that a provider (opentable, resy, sevenrooms) books under for this diner. Call it when the diner names a different address for a provider, or when an availability row says reservation_email_status is "unknown" and the diner gives you one. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_set_reservation_email

Suggest content sources the diner does not follow yet. It suggests and never follows. Pass the handle from birdie_start.

birdie_recommend_sources

Open a conversation and return a handle. Call this once, then pass the handle to every other Birdie tool. The handle carries the diner's taste profile and location, so later calls do not rebuild them. Optionally takes latitude and longitude; without them Birdie assumes New York. Also returns now and timezone, the diner's local clock. Resolve every relative date against it before calling a reservation tool, which wants an absolute start_date_time.

birdie_start

The diner's Fly feed, newest first: visits that earned, checks paid with Fly, challenge payouts, referral bonuses, loads, refunds, Flycard swipes. Plus the restaurant-funded perks waiting for their next visit. venue_name narrows to one place; limit is at most 25. Quote amounts as given. Pass the handle from birdie_start.

birdie_fly_activity

The diner's Fly balance. Quote fly_balance as given. Never convert it to dollars. Pass the handle from birdie_start.

birdie_fly_balance

How much Fly the diner earned in one calendar window: the total, the change against the previous period, a breakdown by source, and the venues they earned the most at. period is weekly, monthly, yearly or all_time; periods_ago pages back (1 is the previous period). Quote amounts as given. Buying Fly is not earning it, so a load's principal never appears here. Pass the handle from birdie_start.

birdie_fly_earnings

What the diner earns on top of a Fly load: the bonus per rail on a one-time buy and on an autoload, and their autoload settings. Rates are percent strings; quote them as given. A 0% rate means no bonus on that rail for this diner today. Pass the handle from birdie_start.

birdie_fly_load_rates

The diners this diner is friends with on Blackbird. Each row carries user_id. Pass it verbatim to birdie_diner_picks, birdie_friend_sources or birdie_friend_lists. Pass the handle from birdie_start.

birdie_friends

The diner's saved lists and the venues on them. Pass list to read one of them. A saved venue is a stated want, which is weaker evidence than a visit but still theirs. Pass the handle from birdie_start.

birdie_my_lists

Recent venue mentions from the sources the diner follows, newest first. Optionally filtered to one source. Pass the handle from birdie_start.

birdie_browse_feed

The diner's spending on Blackbird: Blackbird Pay bills and Flycard swipes, one transaction or a total. Each row's type tells the two apart. Quote amounts as given. since and until take an ISO-8601 date (2026-10-01) or datetime (2026-10-01T19:00:00, with or without a UTC offset). A date alone means midnight at the start of that day in the diner's timezone. since is inclusive; until is exclusive, so until=2026-10-02 ends the window at the close of October 1. For one visit, pass visit_id and visit_type exactly as a birdie_my_visits row gave them. Pass the handle from birdie_start.

birdie_spending

Unblock a diner. It does not restore a friendship. Confirm with the diner first. Pass user_id when a birdie_blocked_diners row gave you one, else name. This tool changes something for the diner. Before you call it, tell them in one plain sentence what changes for them, and get their yes. Pass the handle from birdie_start.

birdie_unblock_diner