Petpooja API and MCP server Let your AI agent run the Petpooja back office.

ToolWhat it doesAccess

• list_outlets Outlets of your account with name, city and whether online ordering is on. read

  Lists the outlets your login opens, in the order Petpooja shows them. Pass an outlet_id from here to every other tool. Nothing is changed.

  MCP callpetpooja_read → list_outlets

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets

  Parameters

  No parameters.

  Example response

  {
    "outlets": [
      {
        "outlet_id": "out_101",
        "name": "Old Town",
        "city": "Ahmedabad",
        "online_ordering": "on"
      },
      {
        "outlet_id": "out_102",
        "name": "Riverside",
        "city": "Surat",
        "online_ordering": "on"
      },
      {
        "outlet_id": "out_103",
        "name": "Airport Road",
        "city": "Vadodara",
        "online_ordering": "off"
      }
    ]
  }

• get_sales_report Day by day sales, discounts and tax for one outlet. read

  Returns one row per day for the outlet and range: bills, gross sales, discounts, tax and net sales, plus totals, in the outlet's currency. Net sales are gross sales minus discounts. Nothing is changed. Your login needs the rights that open the reports.

  MCP callpetpooja_read → get_sales_report

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/sales-report

  Parameters

  Parameters: get_sales_report

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  from date	date	First day of the range. Default: yesterday.
  to date	date	Last day of the range. Default: the same day as from.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_101",
    "currency": "INR",
    "days": [
      {
        "date": "2026-10-29",
        "bills": 412,
        "gross_sales": 61200,
        "discounts": 2800,
        "tax": 2920,
        "net_sales": 58400
      },
      {
        "date": "2026-10-30",
        "bills": 389,
        "gross_sales": 55600,
        "discounts": 2100,
        "tax": 2675,
        "net_sales": 53500
      }
    ],
    "totals": {
      "bills": 801,
      "gross_sales": 116800,
      "discounts": 4900,
      "tax": 5595,
      "net_sales": 111900
    }
  }

• list_bill_exceptions Cancelled, discounted or modified bills and cash drawer operations, with who did them. read

  Returns the entries Petpooja reports for the outlet and range, newest first, each with the bill number, amount, the user who did it, the time and the reason when one was entered. Set type to look at one kind at a time. Nothing is changed.

  MCP callpetpooja_read → list_bill_exceptions

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/bill-exceptions

  Parameters

  Parameters: list_bill_exceptions

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  type string	string	cancelled, discounted, modified or cash_drawer. Default: all four.
  from date	date	First day of the range. Default: yesterday.
  to date	date	Last day of the range. Default: the same day as from.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_101",
    "exceptions": [
      {
        "bill_no": "B-20418",
        "type": "cancelled",
        "amount": 640,
        "user": "cashier_2",
        "at": "2026-10-30T21:14:00+05:30",
        "reason": "Customer left"
      },
      {
        "bill_no": "B-20397",
        "type": "discounted",
        "amount": 1180,
        "user": "manager_1",
        "at": "2026-10-30T20:02:00+05:30",
        "reason": "Staff meal"
      }
    ],
    "next_cursor": null
  }

• get_online_order_reconciliation Per platform: orders, order value, commission, charges, taxes and expected payout. read

  Returns the platform-wise reconciliation Petpooja compiles for online orders at the outlet: orders, order value, commission and its rate, other charges, taxes and the payout expected after them. Compare it with the payout the platform reports. Leave platform out to get every platform. Nothing is changed.

  MCP callpetpooja_read → get_online_order_reconciliation

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/online-order-reconciliation

  Parameters

  Parameters: get_online_order_reconciliation

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  from date	date	First day of the range. Default: yesterday.
  to date	date	Last day of the range. Default: the same day as from.
  platform string	string	Platform name as the report shows it, for example Swiggy or Zomato.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_101",
    "currency": "INR",
    "from": "2026-10-19",
    "to": "2026-10-25",
    "platforms": [
      {
        "platform": "Swiggy",
        "orders": 128,
        "order_value": 76800,
        "commission_rate": "22%",
        "commission": 16896,
        "charges": 3840,
        "taxes": 3733,
        "expected_payout": 52331
      },
      {
        "platform": "Zomato",
        "orders": 94,
        "order_value": 51700,
        "commission_rate": "20%",
        "commission": 10340,
        "charges": 2585,
        "taxes": 2327,
        "expected_payout": 36448
      }
    ]
  }

ToolWhat it doesAccess

• list_menu_items Menu items of an outlet with category, price and whether they are on for online orders. read

  Lists the items of the outlet's menu with their category, price and online status, 100 per page; pass next_cursor back as cursor for the next page. Use query or category to find items, then pass an item_id to the write tools. Nothing is changed.

  MCP callpetpooja_read → list_menu_items

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/menu-items

  Parameters

  Parameters: list_menu_items

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  query string	string	Filter by item name.
  category string	string	Filter by category name.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_101",
    "currency": "INR",
    "items": [
      {
        "item_id": "itm_2201",
        "name": "Masala Dosa",
        "category": "South Indian",
        "price": 140,
        "online": "on"
      },
      {
        "item_id": "itm_2207",
        "name": "Filter Coffee",
        "category": "Beverages",
        "price": 60,
        "online": "on"
      }
    ],
    "next_cursor": null
  }

• set_item_availability Switch a menu item on or off for online orders. write

  Turns one item on or off in the outlet's online menu and returns its new status. Petpooja lets you do the same on its menu screen when stock runs out. Customers cannot order a switched off item, one more call switches it back on, and nothing is sent to anyone, so it runs without asking.

  MCP callpetpooja_write → set_item_availability

  REST endpointPUT https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/items/{item_id}/availability

  Parameters

  Parameters: set_item_availability

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  item_id string required	string	Item ID from list_menu_items.
  available boolean required	boolean	true switches the item on for online orders, false switches it off.

  Example input

  {
    "outlet_id": "outlet_8c41d2",
    "item_id": "item_8c41d2",
    "available": true
  }

  Example response

  {
    "outlet_id": "out_101",
    "item_id": "itm_2201",
    "name": "Masala Dosa",
    "online": "off",
    "changed_at": "2026-10-31T11:02:00+05:30"
  }

• update_item_price Change the price of a menu item. writeasks first

  Sets a new price on one menu item of the outlet and returns the old and the new price. Petpooja then updates the prices on the aggregators connected to the outlet, as it does for a manual change, so every customer pays the new price from then on. By default you confirm each call; you can switch that off for this tool.

  MCP callpetpooja_write → update_item_price

  REST endpointPATCH https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/items/{item_id}/price

  Parameters

  Parameters: update_item_price

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  item_id string required	string	Item ID from list_menu_items.
  price number required	number	New price in the outlet's currency.

  Example input

  {
    "outlet_id": "out_101",
    "item_id": "itm_2207",
    "price": 70
  }

  Example response

  {
    "outlet_id": "out_101",
    "item_id": "itm_2207",
    "name": "Filter Coffee",
    "old_price": 60,
    "price": 70,
    "currency": "INR"
  }

• set_outlet_online_status Switch online ordering for a whole outlet on or off. writeasks first

  Switches the outlet on or off for online ordering and returns its new status. While it is off, customers cannot place online orders at that outlet. Orders already placed are not cancelled. By default you confirm each call; you can switch that off for this tool.

  MCP callpetpooja_write → set_outlet_online_status

  REST endpointPUT https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/online-status

  Parameters

  Parameters: set_outlet_online_status

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  online boolean required	boolean	true switches online ordering on, false switches it off.

  Example input

  {
    "outlet_id": "outlet_8c41d2",
    "online": true
  }

  Example response

  {
    "outlet_id": "out_103",
    "name": "Airport Road",
    "online_ordering": "on",
    "changed_at": "2026-10-31T10:30:00+05:30"
  }

ToolWhat it doesAccess

• list_raw_materials Raw materials of an outlet with current stock and the low stock level. read

  Lists the raw materials in the outlet's inventory with the stock on hand, its unit and the low stock level set in Petpooja. Set low_stock_only to keep the ones at or below that level. Nothing is changed. Your plan needs the Inventory module.

  MCP callpetpooja_read → list_raw_materials

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/raw-materials

  Parameters

  Parameters: list_raw_materials

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  low_stock_only boolean	boolean	Only materials at or below their low stock level.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_101",
    "materials": [
      {
        "material_id": "rm_310",
        "name": "Dosa batter",
        "unit": "kg",
        "stock": 4.5,
        "low_stock_level": 10
      },
      {
        "material_id": "rm_344",
        "name": "Coffee powder",
        "unit": "kg",
        "stock": 1.2,
        "low_stock_level": 2
      }
    ],
    "next_cursor": null
  }

• list_purchase_orders Purchase orders of an outlet with supplier, status and item count. read

  Lists the purchase orders raised for the outlet, newest first, from the Purchase Manager: supplier or central kitchen, status as Petpooja shows it, the number of items and the date. Nothing is changed.

  MCP callpetpooja_read → list_purchase_orders

  REST endpointGET https://cotlet.dev/api/v1/petpooja/outlets/{outlet_id}/purchase-orders

  Parameters

  Parameters: list_purchase_orders

  Name	Type	Description
  outlet_id string required	string	Outlet ID from list_outlets.
  status string	string	Status as the Purchase Manager shows it, for example Pending.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "outlet_id": "outlet_8c41d2"
  }

  Example response

  {
    "outlet_id": "out_102",
    "purchase_orders": [
      {
        "po_id": "po_7712",
        "supplier": "Central Kitchen",
        "status": "Pending",
        "items": 6,
        "created": "2026-10-29"
      },
      {
        "po_id": "po_7698",
        "supplier": "Fresh Dairy Co",
        "status": "Accepted",
        "items": 3,
        "created": "2026-10-26"
      }
    ],
    "next_cursor": null
  }

ToolWhat it doesAccess

• list_customers CRM customers with visits, reward points and last visit. read

  Lists the customers saved in Petpooja's CRM, newest visit first, with contact details, the number of visits and the reward points. Search by name, phone or email. Pages hold up to 100 customers; pass next_cursor back as cursor for the next page. Nothing is changed or sent.

  MCP callpetpooja_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/petpooja/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Search by name, phone or email.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "customers": [
      {
        "customer_id": "cus_5101",
        "name": "Maya Shah",
        "phone": "+91 98000 00000",
        "email": "maya@example.com",
        "visits": 7,
        "reward_points": 240,
        "last_visit": "2026-10-28"
      }
    ],
    "next_cursor": null
  }