DoorDash API and MCP server Let your AI agent order from DoorDash.

ToolWhat it doesAccess

• search_stores Find restaurants and stores that deliver to an address, by search term or cuisine. read

  Returns stores in the order DoorDash ranks them for the address, each with its name, cuisine, rating, whether it is open and the delivery time estimate DoorDash shows. It searches the same catalog as the app, so restaurants, grocery and convenience stores all show up. The fees DoorDash shows on a store card are not final: use preview_order for the total.

  MCP calldoordash_read → search_stores

  REST endpointGET https://cotlet.dev/api/v1/doordash/stores/search

  Parameters

  Parameters: search_stores

  Name	Type	Description
  query string required	string	Free-form search, for example "pad thai", "pizza" or "groceries".
  address_id string	string	A saved address from list_addresses. Defaults to your default address.
  fulfillment string	string	delivery or pickup. Defaults to delivery.
  limit integer	integer	How many stores to return.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "address_id": "addr_1042",
    "stores": [
      {
        "store_id": "st_88123",
        "name": "Basil Thai Kitchen",
        "cuisine": "Thai",
        "rating": 4.7,
        "open": true,
        "eta_minutes": 32
      },
      {
        "store_id": "st_55871",
        "name": "Noodle Corner",
        "cuisine": "Thai",
        "rating": 4.5,
        "open": true,
        "eta_minutes": 40
      }
    ]
  }

• get_store_menu Read the menu or catalog of one store, with item names, prices and categories. read

  Returns the menu in the categories the store uses, each item with its item_id, name and price. Prices are the store's menu prices and can differ from in-store prices. Item options such as size or toppings come from get_item. A closed store still returns its menu.

  MCP calldoordash_read → get_store_menu

  REST endpointGET https://cotlet.dev/api/v1/doordash/stores/{store_id}/menu

  Parameters

  Parameters: get_store_menu

  Name	Type	Description
  store_id string required	string	A store_id from search_stores.
  query string	string	Only items whose name matches this text.

  Example input

  {
    "store_id": "store_8c41d2"
  }

  Example response

  {
    "store_id": "st_88123",
    "name": "Basil Thai Kitchen",
    "categories": [
      {
        "name": "Noodles",
        "items": [
          {
            "item_id": "it_3021",
            "name": "Pad Thai",
            "price": 14.5
          },
          {
            "item_id": "it_3022",
            "name": "Drunken Noodles",
            "price": 15
          }
        ]
      }
    ]
  }

• get_item Read one menu item with its required and optional choices. read

  Returns the item's description, price and option groups, each marked required or optional, with the choices and any extra price. Read it before add_to_cart so the required choices are not missed. It changes nothing in your cart.

  MCP calldoordash_read → get_item

  REST endpointGET https://cotlet.dev/api/v1/doordash/stores/{store_id}/items/{item_id}

  Parameters

  Parameters: get_item

  Name	Type	Description
  store_id string required	string	A store_id from search_stores.
  item_id string required	string	An item_id from get_store_menu.

  Example input

  {
    "store_id": "store_8c41d2",
    "item_id": "item_8c41d2"
  }

  Example response

  {
    "item_id": "it_3021",
    "name": "Pad Thai",
    "price": 14.5,
    "option_groups": [
      {
        "name": "Protein",
        "required": true,
        "choices": [
          {
            "choice_id": "ch_1",
            "name": "Chicken",
            "extra": 0
          },
          {
            "choice_id": "ch_2",
            "name": "Shrimp",
            "extra": 2
          }
        ]
      },
      {
        "name": "Spice level",
        "required": false,
        "choices": [
          {
            "choice_id": "ch_7",
            "name": "Mild",
            "extra": 0
          },
          {
            "choice_id": "ch_8",
            "name": "Hot",
            "extra": 0
          }
        ]
      }
    ]
  }

• list_addresses List the delivery addresses saved on your DoorDash account. read

  Returns each saved address with its label, street and whether it is the default. The agent uses one of them for search_stores and submit_order. It cannot add an address; only addresses already saved in DoorDash can be chosen.

  MCP calldoordash_read → list_addresses

  REST endpointGET https://cotlet.dev/api/v1/doordash/addresses

  Parameters

  No parameters.

  Example response

  {
    "addresses": [
      {
        "address_id": "addr_1042",
        "label": "Home",
        "street": "221 Example Street, Springfield",
        "default": true
      },
      {
        "address_id": "addr_1043",
        "label": "Work",
        "street": "90 Sample Avenue, Springfield",
        "default": false
      }
    ]
  }

ToolWhat it doesAccess

• add_to_cart Add an item with its choices to the cart of a store. Starts a cart if the store has none. write

  Returns the cart with the new item and its subtotal. A cart reaches no one and spends nothing, and remove_from_cart undoes it, so it runs without asking you. A missing required choice fails the call and lists what is missing. Nothing is ordered until submit_order.

  MCP calldoordash_write → add_to_cart

  REST endpointPOST https://cotlet.dev/api/v1/doordash/stores/{store_id}/carts

  Parameters

  Parameters: add_to_cart

  Name	Type	Description
  store_id string required	string	A store_id from search_stores.
  item_id string required	string	An item_id from get_store_menu.
  quantity integer	integer	How many. Defaults to 1.
  choice_ids array	array	choice_id values from get_item. All required choices must be given.
  note string	string	A special instruction for the store.

  Example input

  {
    "store_id": "st_88123",
    "item_id": "it_3021",
    "quantity": 2,
    "choice_ids": [
      "ch_1",
      "ch_8"
    ]
  }

  Example response

  {
    "cart_id": "cart_7781",
    "store": "Basil Thai Kitchen",
    "items": [
      {
        "item_id": "it_3021",
        "name": "Pad Thai",
        "quantity": 2,
        "choices": [
          "Chicken",
          "Hot"
        ]
      }
    ],
    "subtotal": 29
  }

• get_cart Read your open carts, or one cart with its items. read

  Returns each cart's store, items with their choices, quantities and the subtotal. A cart is per store, so two stores mean two carts. The subtotal does not include fees, tax or tip: use preview_order for the amount you would pay.

  MCP calldoordash_read → get_cart

  REST endpointGET https://cotlet.dev/api/v1/doordash/cart

  Parameters

  Parameters: get_cart

  Name	Type	Description
  cart_id string	string	One cart. Leave out to list all open carts.

  Example response

  {
    "carts": [
      {
        "cart_id": "cart_7781",
        "store": "Basil Thai Kitchen",
        "items": [
          {
            "item_id": "it_3021",
            "name": "Pad Thai",
            "quantity": 2,
            "choices": [
              "Chicken",
              "Hot"
            ]
          }
        ],
        "subtotal": 29
      }
    ]
  }

• remove_from_cart Remove one item from a cart, or delete the whole cart. write

  Returns the cart as it is after the change, or deleted. It touches only the cart, reaches no one and costs nothing, so it runs without asking you. Never use it on a cart you want to keep: a deleted cart has to be built again.

  MCP calldoordash_write → remove_from_cart

  REST endpointDELETE https://cotlet.dev/api/v1/doordash/carts/{cart_id}

  Parameters

  Parameters: remove_from_cart

  Name	Type	Description
  cart_id string required	string	A cart_id from get_cart.
  item_id string	string	The item to remove. Leave out to delete the whole cart.

  Example input

  {
    "cart_id": "cart_8c41d2"
  }

  Example response

  {
    "cart_id": "cart_7781",
    "status": "deleted"
  }

• reorder Put the items of a past order into a new cart, without ordering. write

  Returns a new cart with the items of that order, at today's prices. Items the store no longer sells are listed as unavailable. It only fills a cart, so it reaches no one and runs without asking you; call preview_order and then submit_order to buy.

  MCP calldoordash_write → reorder

  REST endpointPOST https://cotlet.dev/api/v1/doordash/orders/{order_id}/reorder/reorder

  Parameters

  Parameters: reorder

  Name	Type	Description
  order_id string required	string	An order_id from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "cart_id": "cart_7790",
    "store": "Basil Thai Kitchen",
    "items": [
      {
        "item_id": "it_3021",
        "name": "Pad Thai",
        "quantity": 2
      }
    ],
    "unavailable": [],
    "subtotal": 30
  }

• list_payment_methods List the payment methods saved on your DoorDash account, without card numbers. read

  Returns each saved method with its type, brand, last four digits and whether it is the default. Full card numbers are never returned. It cannot add or change a method; to pay with another one, add it in DoorDash first.

  MCP calldoordash_read → list_payment_methods

  REST endpointGET https://cotlet.dev/api/v1/doordash/payment-methods

  Parameters

  No parameters.

  Example response

  {
    "payment_methods": [
      {
        "payment_method_id": "pm_201",
        "type": "card",
        "brand": "Visa",
        "last4": "4242",
        "default": true
      }
    ]
  }

• preview_order Show the full price of a cart before anything is bought: fees, tax, tip and the total. read

  Returns the lines DoorDash shows at checkout: subtotal, delivery fee, service fee, tax, tip, any discount or credit, and the total, plus the delivery time. Nothing is charged and the order is not placed. Fees change with the store, address, time and your DashPass status, so preview again right before submit_order.

  MCP calldoordash_read → preview_order

  REST endpointGET https://cotlet.dev/api/v1/doordash/carts/{cart_id}/orders/preview

  Parameters

  Parameters: preview_order

  Name	Type	Description
  cart_id string required	string	A cart_id from get_cart or add_to_cart.
  fulfillment string	string	delivery or pickup. Defaults to delivery.
  delivery_speed string	string	standard or priority. Defaults to standard.
  tip number	number	Tip in dollars.
  promo_code string	string	A promo code to try on this cart.

  Example input

  {
    "cart_id": "cart_8c41d2"
  }

  Example response

  {
    "cart_id": "cart_7781",
    "fulfillment": "delivery",
    "delivery_speed": "standard",
    "lines": {
      "subtotal": 29,
      "delivery_fee": 2.99,
      "service_fee": 4.35,
      "tax": 2.61,
      "tip": 5,
      "discount": 0
    },
    "total": 43.95,
    "eta_minutes": 34
  }

ToolWhat it doesAccess

• submit_order Place the order for a cart and charge your saved payment method. writeasks first

  Places a real order and charges your payment method, so the call waits for your approval, with the cart and the total shown to you. It fails without charging when the total is higher than expected_total. DoorDash decides about changes and cancellations after the order is placed, and Cotlet has no tool to cancel it. Returns the order_id and the estimated arrival. By default you confirm each call; you can switch that off for this tool.

  MCP calldoordash_write → submit_order

  REST endpointPOST https://cotlet.dev/api/v1/doordash/carts/{cart_id}/order/submit

  Parameters

  Parameters: submit_order

  Name	Type	Description
  cart_id string required	string	A cart_id from get_cart.
  expected_total number required	number	The total from preview_order in dollars. The call fails if the total is now higher.
  address_id string	string	A saved address from list_addresses. Defaults to your default address.
  payment_method_id string	string	A saved method from list_payment_methods. Defaults to your default method.
  fulfillment string	string	delivery or pickup. Defaults to delivery.
  delivery_speed string	string	standard or priority. Defaults to standard.
  tip number	number	Tip in dollars.

  Example input

  {
    "cart_id": "cart_8c41d2",
    "expected_total": 1
  }

  Example response

  {
    "order_id": "ord_90121",
    "status": "placed",
    "store": "Basil Thai Kitchen",
    "total_charged": 43.95,
    "eta": "2026-10-27T19:12:00-05:00"
  }

• list_orders List your past and open DoorDash orders, newest first. read

  Returns each order with its order_id, store, date, number of items, total and status. Use an order_id with get_order_status, get_order_receipt or reorder. It reads the history your account shows in the app.

  MCP calldoordash_read → list_orders

  REST endpointGET https://cotlet.dev/api/v1/doordash/orders

  Parameters

  Parameters: list_orders

  Name	Type	Description
  status string	string	open for orders still on their way, past for delivered or cancelled ones. Defaults to all.
  limit integer	integer	How many orders to return.

  Example response

  {
    "orders": [
      {
        "order_id": "ord_90114",
        "store": "Basil Thai Kitchen",
        "placed_at": "2026-10-24T18:42:00-05:00",
        "items": 4,
        "total": 52.4,
        "status": "delivered"
      },
      {
        "order_id": "ord_90102",
        "store": "Slice House Pizza",
        "placed_at": "2026-10-21T19:05:00-05:00",
        "items": 2,
        "total": 31.2,
        "status": "delivered"
      }
    ]
  }

• get_order_status Read where an open order is and when it should arrive. read

  Returns the status DoorDash shows for the order, such as being prepared or on its way, and the estimated arrival time. A delivered order returns its delivery time. It does not message the Dasher or the store.

  MCP calldoordash_read → get_order_status

  REST endpointGET https://cotlet.dev/api/v1/doordash/orders/{order_id}/status

  Parameters

  Parameters: get_order_status

  Name	Type	Description
  order_id string required	string	An order_id from list_orders or submit_order.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "ord_90121",
    "status": "on_the_way",
    "eta": "2026-10-27T19:12:00-05:00",
    "store": "Basil Thai Kitchen"
  }

• get_order_receipt Read the itemized receipt of a past order. read

  Returns the items, fees, tax, tip, discounts and the total charged, the same lines the receipt in the app shows. It does not download a PDF. Open orders have no final receipt until they are delivered.

  MCP calldoordash_read → get_order_receipt

  REST endpointGET https://cotlet.dev/api/v1/doordash/orders/{order_id}/receipt

  Parameters

  Parameters: get_order_receipt

  Name	Type	Description
  order_id string required	string	An order_id from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "ord_90114",
    "store": "Basil Thai Kitchen",
    "items": [
      {
        "name": "Pad Thai",
        "quantity": 2,
        "price": 29
      },
      {
        "name": "Spring Rolls",
        "quantity": 2,
        "price": 12
      }
    ],
    "lines": {
      "subtotal": 41,
      "delivery_fee": 2.99,
      "service_fee": 6.15,
      "tax": 3.26,
      "tip": 5
    },
    "total_charged": 58.4
  }