hktitan/swiggy-cli

List, create, delete and default Swiggy delivery addresses with swiggy-cli. Use when a Food/Instamart command needs an addressId, when the user says "deliver to my office", "add a new address", or when the CLI exits 2 asking for --address-id.

Read and change a Swiggy Food or Instamart cart with swiggy-cli — add items, change quantities, apply coupons, clear. Use when the user says "add X", "make it two", "what's in my cart", "apply coupon", "empty my cart".

Place a Swiggy Food or Instamart order with swiggy-cli, choosing Cash, UPI or Swiggy Money and getting explicit consent first. Use only when the user has said to place/confirm the order — never as an automatic continuation of adding to cart.

Drive the swiggy CLI (wrapper over the official Swiggy MCP servers — Food, Instamart, Dineout) from an agent. Use when the user wants to search, order, pay for, book or track anything on Swiggy through the terminal. Covers machine-mode flags, the JSON envelope, exit codes, auth detection and when NOT to use the CLI.

Find a restaurant, check table slots and book (free or paid deal) on Swiggy Dineout with swiggy-cli; also check or cancel a booking. Use when the user says "book a table", "reserve", "is X free at 8pm", "cancel my reservation".

Use the official Swiggy MCP servers (Food at mcp.swiggy.com/food, Instamart at /im, Dineout at /dineout — 51 tools) correctly from any MCP client or agent framework. Use when an agent has Swiggy MCP tools available, or when writing code that calls them. Covers auth (OAuth 2.1 + PKCE, one token, 5-day expiry), the {success,data,message} envelope, error handling, rate limits and session hygiene, and the safety rules every Swiggy tool call must follow.

Book restaurant tables through the Swiggy Dineout MCP server (mcp.swiggy.com/dineout) — location → search → details → slots → book (free) or create_cart + book_table with UPI (paid deal) → status / cancel. Use when an agent with Swiggy Dineout tools must find a place to eat out, check availability, reserve, or cancel. Assumes the swiggy-mcp skill.

Look up the authoritative Swiggy Builders Club docs before writing or reviewing any code, config or prompt that touches Swiggy MCP (Food, Instamart, Dineout). Use when a coding agent needs a tool name, parameter, response field, error, rate limit, auth detail or client config for Swiggy MCP — fetch, verify, then answer; never guess.

Order food for delivery through the Swiggy Food MCP server (mcp.swiggy.com/food) — address → search → menu → cart → coupon → place order → track. Use when an agent with Swiggy Food tools must find restaurants or dishes, build a cart, apply coupons, place or track a delivery order. Assumes the swiggy-mcp skill.

Order groceries through the Swiggy Instamart MCP server (mcp.swiggy.com/im) — address → search or go-to items → set cart → coupons → checkout → track. Use when an agent with Swiggy Instamart tools must find products, build or edit a grocery cart, apply coupons, check out or track a delivery. Assumes the swiggy-mcp skill.

Take payment on Swiggy MCP — the shared Payment stage (get_payment_options → place-order → check_payment_status → confirm_order) for Food, Instamart and Dineout, with UPI app intent, scan-QR, Cash and Swiggy Money, in both widget and headless clients. Use whenever an order or paid booking must be paid for, a place-order tool returned PENDING_PAYMENT, or the user asks about payment status. Assumes the swiggy-mcp skill.

Complete an in-flight Swiggy UPI payment with swiggy-cli — share the pay link, poll payment status on Swiggy's cadence, confirm the order, handle failure/refund/timeout. Use after a checkout or booking returned PENDING_PAYMENT, or when the user asks "did my payment go through".

Find restaurants, dishes, grocery products or dine-in venues on Swiggy with swiggy-cli. Use when the user says "find", "search", "what's available", "show me options", "is X on Swiggy" — before any cart, order or booking step.

List, inspect and live-track Swiggy Food and Instamart orders and Dineout bookings with swiggy-cli. Use when the user asks "where's my order", "what did I order", "is it delivered", "show my bookings".