# Foodpanda MCP

> Foodpanda MCP lets you take full control of large-scale food delivery operations from any AI agent. Use this tool to manage entire vendor catalogs, track every order detail across chains, and update operational statuses—all without logging into multiple portals.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** food-delivery, vendor-management, menu-management, order-tracking, marketplace-api

## Description

Connect your Foodpanda Partner account to your AI client and run your entire food delivery operation through natural conversation. Instead of manually jumping between dashboards or updating menus one by one, you give your agent the job, and it does the work. You can handle everything from managing product catalogs for an entire chain to checking real-time order status across multiple vendors. Your AI acts like a dedicated operations manager that lives inside your workflow. For example, need to set a vendor's status to 'busy' because of high volume? Or perhaps you just finished updating 50 new menu items? You tell your agent, and it handles the updates directly through this MCP connection. Vinkius makes sure your AI client connects once and gains access to all these tools, meaning no more scattered logins for your operations team.

## Tools

### add_catalog_products
Adds specific new products to the vendor catalog across your entire chain.

### get_catalog_job
Checks the status of asynchronous background jobs related to the product catalog updates.

### export_catalog
Pulls a full, exportable dataset of the vendor's current menu and product listings.

### get_order_details
Retrieves all specific information regarding an individual order ID.

### get_order_history
Fetches a list of past orders for a given vendor, allowing you to filter by date range.

### get_promotion_job
Checks the status of any background job related to promotional campaign changes.

### update_vendor_catalog
Makes bulk updates and modifications to the vendor's existing product catalog.

### update_order
Changes specific details or status information on an active order.

### update_vendor_status
Sets the operational status of a vendor (open, closed, busy) for immediate customer visibility.

### upsert_promotion
Creates or modifies promotional campaigns across your chain's offerings.

### get_vendor_catalog
Retrieves the current, complete product listing for a specific vendor.

### get_vendor_categories
Lists and retrieves all organizational categories used by a particular vendor's menu.

### get_vendor_status
Checks the current operational status of any specified vendor.

## Prompt Examples

**Prompt:** 
```
Show me the complete catalog for vendor 12345 in chain 67890.
```

**Response:** 
```
I've fetched the vendor catalog. This restaurant has 45 active products across 8 categories, including burgers, sides, and beverages. The most popular item is the Classic Burger combo.
```

**Prompt:** 
```
What's the status of order ORD-98765?
```

**Response:** 
```
Order ORD-98765 is currently being prepared. It was placed at 14:32 with 3 items: 2x Classic Burger, 1x Fries Large. Estimated delivery time is 25 minutes.
```

**Prompt:** 
```
Set vendor 12345 to busy status due to high order volume.
```

**Response:** 
```
Done! Vendor 12345 is now set to 'busy' status. Customers will see an extended delivery time estimate. The reason 'high order volume' has been recorded.
```

## Capabilities

### Manage vendor menus
You can pull complete product catalogs, export current menu data, or add new products across an entire chain of restaurants.

### Monitor and update orders
The agent retrieves full order histories, gets specific order details, and updates the status of any active delivery job in real time.

### Control promotions and vendor status
You can create or modify promotional campaigns, check a vendor's current operational status (open, closed, busy), and update that status when needed.

## Use Cases

### A franchise needs to launch a new side item.
The manager asks the agent to add the 'Spicy Chili Fries' to all locations. The agent uses `add_catalog_products`, confirming that the product is added and running through the necessary background job status checks using `get_catalog_job`.

### A vendor is overwhelmed during lunch rush.
The coordinator asks the agent to set Vendor 456's status. The agent runs `update_vendor_status`, immediately alerting customers that delivery times are extended, preventing bad customer experiences.

### We need to analyze sales trends from last month.
The director asks the agent for order data. It uses `get_order_history` and then provides a structured dataset, letting them pull metrics without downloading CSVs or navigating complex date filters.

### A promotion needs to be updated across 10 different chains.
The ops team tells the agent to change the 'Buy One Get One' deal. The agent uses `upsert_promotion`, confirming its success, and then runs `get_promotion_job` to ensure it’s live everywhere.

## Benefits

- Stop switching between portals. Your agent handles everything from fetching order details using `get_order_details` to updating the status with `update_vendor_status`, all in one conversation.
- Gain instant menu control. You can run `export_catalog` to pull current data or use `add_catalog_products` to push new items, ensuring consistency across every location.
- Stay ahead of peak times. Instead of manually logging in when a store gets overwhelmed, your agent monitors and updates the status using `update_vendor_status` instantly.
- Run complex campaigns easily. Use `upsert_promotion` to create or modify promotions, then use `get_promotion_job` to confirm the campaign is live across all required vendors.
- Optimize dispatching with history. Need proof of volume? Run `get_order_history` to fetch past order data and analyze trends without leaving your workflow.

## How It Works

The bottom line is that your AI client handles complex API calls so you don't have to remember which portal controls which piece of data.

1. First, subscribe to this MCP and provide your Foodpanda Partner API OAuth 2.0 Bearer token.
2. Second, prompt your AI client with the specific operational task you need done (e.g., 'Check all promotions for chain XYZ').
3. Third, your agent uses the exposed tools to fetch or update the necessary data and reports the outcome back to you.

## Frequently Asked Questions

**How do I manage multiple vendor menus using Foodpanda MCP?**
You can use `get_vendor_catalog` or `export_catalog` to pull the full menu data. To make changes, run `add_catalog_products` or `update_vendor_catalog` across your chain.

**Can I track an order's status with Foodpanda MCP?**
Yes. Use `get_order_details` to retrieve specific details on a single order, or use `get_order_history` for a vendor's full activity log over a date range.

**What if I need to temporarily close a store?**
You can use `update_vendor_status`. This allows you to set the vendor's status (open, closed, busy) instantly, which updates what customers see in real-time.

**Does Foodpanda MCP handle promotions?**
Yes. You can use `upsert_promotion` to create or modify campaigns and then check if the job was successful using `get_promotion_job`.

**Do I need special coding knowledge for Foodpanda MCP?**
No. You only talk to your agent in plain language. The underlying complexity of API calls is handled entirely by this MCP, letting you focus on the operational goal.