Forkable
Arcade Optimized
Arcade tools for Forkable — list this week's meals, browse menus, and pick what you want delivered
Author:Arcade
Version:
1.0.3Auth:No authentication required
5tools
5require secrets
Forkable is a corporate lunch delivery service; this toolkit lets an Arcade agent browse this week's menus, check dietary conflicts, and swap or skip a user's assigned meal.
Capabilities
- Weekly schedule — retrieve upcoming delivery days, current pick status (open / locked / delivered), and available menu IDs for each day.
- Menu browsing — fetch full menus including sections, items, prices, and modifiers for one or more menu IDs.
- Meal selection & changes — swap an existing assigned meal for a different menu item and surface the updated amount due.
- Dietary safety checks — validate a prospective item + modifier combination against the user's dietary restrictions before picking.
- Skip a delivery — remove an assigned meal from an open, unlocked order.
Secrets
Authentication is credential-based (email + password). Both secrets must be configured before any tool call.
FORKABLE_EMAIL— The email address used to log in to the user's Forkable account. Obtain it from the account holder directly or from your organization's Forkable admin.FORKABLE_PASSWORD— The plaintext password for the same Forkable account. Obtain it from the account holder. Because this is a live account password, treat it with the same care as any privileged credential and rotate it if the account password changes.
For instructions on storing secrets in Arcade, see the Arcade secrets guide. You can also manage secrets directly at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(5)
5 of 5 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Check whether picking this item (with the given modifier selections) would
conflict with the signed-in user's dietary restrictions.
Returns the list of conflict tags (e.g. `["dairy_free"]`) — empty if the
item is safe. Call this before picking the item as a meal to warn the user, or
to let the agent pick a different item. | 2 | ||
Fetch the full menu (sections, items, prices, modifiers) for one or more menu IDs.
Each item ships with the `item_id` and `menu_id` you'll need to pick it as your meal. | 2 | ||
List your upcoming Forkable delivery days and what's currently picked for each.
Each entry shows the delivery date, current state (open / locked / delivered),
the meal currently assigned to you (`my_pick`), and the menu IDs whose items you
can swap your pick to. Results are sorted by delivery date.
An entry whose `my_pick.piece_id` is empty has no meal allocated to you yet, so
there is no pick to swap on it; picking a meal only replaces an existing pick. | 2 | ||
Replace your assigned meal on one delivery with a different menu item.
Only works on deliveries that already have a meal allocated to you (a
non-empty `my_pick.piece_id`). Forkable's `replacePiece` mutation swaps an
existing pick; it can't create one from nothing — initial allocation
happens on the Forkable side.
The mutation returns the refreshed delivery; this tool surfaces the new pick
and the updated amount due. | 2 | ||
Skip a day — removes your assigned meal from a Forkable order.
Use only when the delivery is still open for changes (`locked: false`
and not `past_late_order_deadline`). | 2 |
Last updated on