# PedidosYa MCP for AI Agents AI Agent Connect > PedidosYa MCP lets you manage your restaurant's food delivery operations through your AI agent. Handle incoming orders, toggle menu items, and request couriers across Latin America without switching tabs. It connects your partner account to any MCP-compatible client so you can run your business via natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JGwFPC5izK6YlpO0XuMZDrEtgWGcIDnMbSA8ZhY0/ai-agent-connect - **Tags:** food-delivery, restaurant-operations, menu-management, logistics, order-processing ## Description This Connector connects your PedidosYa partner account to your AI agent so you can handle the heavy lifting of food delivery management without constantly checking a tablet. Instead of jumping between different screens to see what is cooking or what is sold out, you just talk to your agent. You can tell it to accept a batch of orders while you are busy in the kitchen or ask it to put a specific dish on sold out status the second you run out of ingredients. It handles the logistical side too, like requesting couriers for B2B deliveries or tracking where a shipment is in real-time. If you are running multiple locations, you can pull up the stats for all your venues at once to see how they are performing. It even lets you set up webhooks so your agent knows the moment an order is canceled or a courier arrives. Vinkius makes it easy to plug this into your existing workflow, giving you a way to stay on top of your business without the constant manual data entry. You get a clear view of your menu sections, prices, and restaurant details, making it a lot easier to keep your marketplace presence accurate. You can manage your entire operation from a single chat interface, whether you are checking your prep times or adjusting your delivery radius. It takes the friction out of managing a high-volume food business by letting you focus on the food while the agent handles the data. ## Tools ### get_order Pull all the specific details for a single customer order. Use this to see item lists, prices, and customer notes. ### request_courier Book a courier for a B2B delivery with specific pickup and dropoff info. This is ideal for moving goods outside the regular order flow. ### track_shipment Monitor the real-time GPS location of an active courier shipment. This lets you see exactly where your delivery is. ### update_product_price Change the cost of a menu item on your live listing. This update takes effect immediately for all customers. ### update_product_status Toggle a specific product as sold out or available. You can do this without having to edit your entire menu. ### accept_order Confirm a pending order to start the preparation process. This tells the system to begin assigning a delivery courier. ### create_webhook Set up automated alerts for events like new orders or courier assignments. This keeps your agent updated on your business status. ### get_restaurant View the configuration and details for one of your registered venues. This helps you check operating hours and prep times. ### list_menu_sections See all your menu categories, products, and current pricing. This is useful for reviewing your full marketplace listing. ### list_orders View all incoming orders and filter them by their current status. Use this to find pending orders that need attention. ### list_restaurants Get a list of all your partner venues and their operating states. This helps you manage multiple locations at once. ### list_webhooks Check which automated notifications you currently have active. Use this to manage your webhook subscriptions. ### mark_order_ready Notify the system that food is ready so a courier can be dispatched. This triggers the delivery process for the customer. ### reject_order Decline a pending order with a specific reason like out of stock. This helps you manage demand when you are too busy. ## Prompt Examples **Prompt:** ``` What's the status of my current orders? ``` **Response:** ``` ### Current Orders | Order ID | Items | Status | Time | | :--- | :--- | :--- | :--- | | **#PY-88412** | 2x Burger Clásica, 1x Papas Fritas | **Preparing** | 5 min ago | | **#PY-88415** | 1x Pizza Margherita, 2x Coca-Cola | **Pending** | 2 min ago | | **#PY-88418** | 3x Empanadas, 1x Flan | **Ready** | Just now | Would you like me to accept the pending order for you? ``` **Prompt:** ``` We're out of tacos. Hide them from the menu. ``` **Response:** ``` Done! I have updated the menu for your restaurant. The **Tacos** are now marked as **sold out** and will be hidden from the customer view until you re-enable them. Is there anything else you need to change? ``` **Prompt:** ``` Book a courier from our warehouse to the downtown cafe. ``` **Response:** ``` ### Courier Requested * **Shipment ID:** #SH-77201 * **Pickup:** Warehouse Hub * **Dropoff:** Downtown Cafe * **Status:** Courier assigned You can ask me for a status update anytime using the shipment ID **#SH-77201**. ``` ## Capabilities ### Accept and reject food orders Confirm pending orders to start preparation or decline them if you are too busy. ### Toggle menu availability Mark items as sold out or bring them back online instantly. ### Update live pricing Change the cost of menu products on your marketplace listing in real-time. ### Request B2B couriers Schedule on-demand courier pickups for deliveries outside the standard order flow. ### Track courier GPS Monitor the real-time location of active shipments for your business. ### Monitor venue performance Query operating hours, prep times, and marketplace stats for all your locations. ### Automate status alerts Configure webhooks to get notified about new orders, cancellations, and assignments. ## Use Cases ### Sold out during a rush A chef tells the agent to use update_product_status on the Special Burger because they ran out of meat during a busy dinner shift. ### B2B delivery scheduling A warehouse manager uses request_courier to send a package from the main hub to a local retail partner in the city. ### Multi-venue management A dark kitchen owner uses list_restaurants to see which of their three locations are currently open and busy. ### Order triage A manager uses list_orders to see everything pending and asks the agent to accept all orders that are marked as ready for pickup. ## Benefits - Stop constantly checking your tablet by using accept_order to handle the queue from your chat. - Keep your menu accurate with update_product_status to hide items the moment they sell out. - Adjust your pricing instantly using update_product_price to react to costs without manual edits. - Schedule B2B deliveries easily with request_courier to move goods outside the standard order flow. - Stay on top of your fleet with track_shipment to see exactly where your couriers are in real-time. - Automate your notifications by using create_webhook to get alerted on cancellations or new orders. ## How It Works The bottom line is you can run your entire delivery operation from a single chat interface. 1. Enter your PedidosYa Partner Client ID and Secret into the Connector configuration. 2. Connect the Connector to your preferred AI client like Claude, Cursor, or Windsurf. 3. Start managing your orders, menu items, and courier logistics through natural conversation. ## Frequently Asked Questions **How does the PedidosYa MCP help my restaurant?** It lets you manage your entire delivery presence through a chat interface. You can accept orders, update prices, and manage couriers without needing to keep a tablet in front of you at all times. **Can I use the PedidosYa MCP to manage multiple locations?** Yes, you can use it to list and query all your registered restaurants. This is great for dark kitchen operators who need to see the status of several venues at once. **Does the PedidosYa MCP handle B2B courier requests?** It does. You can use it to schedule on-demand courier pickups for deliveries that happen outside the standard food order flow. **How do I update my menu using the PedidosYa MCP?** You can just tell your agent to toggle specific products on or off. It will immediately update your live marketplace listing to show items as sold out or available. **Can the PedidosYa MCP track my deliveries?** Yes, it includes tools to track courier shipments in real-time. You can ask your agent for the GPS location of any active delivery. **Will the PedidosYa MCP help me stay on top of order cancellations?** You can set up webhooks to get automatic updates. Your agent will be notified the moment an order is canceled or a courier is assigned. **Can my AI agent accept or reject incoming orders automatically?** Yes! Use `accept_order` to confirm an incoming order or `reject_order` with a reason (out_of_stock, closing_soon, too_busy, item_unavailable). Once accepted, the PedidosYa system begins assigning a delivery courier. When ready, use `mark_order_ready` to signal the courier for pickup. **How do I mark items as sold out on my live menu?** Use the `update_product_status` tool with the restaurant ID, product ID, and set `available` to false. The product will immediately show as unavailable on PedidosYa. To bring it back, call the same tool with `available` set to true. **Can I request a courier for deliveries outside of food orders?** Yes! Use the `request_courier` tool to create a shipment request with pickup and dropoff addresses. This leverages PedidosYa's logistics network for B2B courier services, independent of restaurant orders. Track the courier in real-time with `track_shipment`.