PedidosYa MCP. Automate order flow and courier logistics.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
PedidosYa MCP Server manages full restaurant operations across Latin America's leading food delivery platform. Use it through any AI agent to accept/reject orders, update product prices on the fly, request couriers for B2B pickups, and track deliveries—all without touching your tablet.
What your AI agents can do
Accept order
Accepts a specific pending order, committing the restaurant to prepare the items for pickup.
Create webhook
Sets up automated webhooks so your agent is notified when events like new orders or cancellations occur.
Get order
Retrieves the full details, contents, and status of a single, specific order ID.
Accepts incoming orders to commit the restaurant to preparation time, or rejects them with a specified reason.
Updates product pricing and toggles individual items on or off (sold out) without editing the entire menu structure.
Requests immediate courier dispatch for B2B deliveries or tracks existing shipments in real time.
Retrieves structured data on all registered restaurants, including operational status and performance metrics.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
PedidosYa: 14 Tools for Restaurant Operations
These tools let your agent handle the entire order lifecycle—from accepting a pending request to tracking the final delivery and updating prices on demand.
019d846aaccept order
Accepts a specific pending order, committing the restaurant to prepare the items for pickup.
019d846acreate webhook
Sets up automated webhooks so your agent is notified when events like new orders or cancellations occur.
019d846aget order
Retrieves the full details, contents, and status of a single, specific order ID.
019d846aget restaurant
Gets current operational details for a specified restaurant location.
019d846alist menu sections
Lists all menu categories and the products within them, including their prices and current availability status.
019d846alist orders
Filters incoming orders by status (pending, preparing, ready) to show a list of required actions.
019d846alist restaurants
Provides an overview of all your partner restaurant locations and their current open/closed status.
019d846alist webhooks
Retrieves a list of all webhook subscriptions currently configured for the account.
019d846amark order ready
Changes an order status to ready, automatically triggering courier dispatch if one hasn't been assigned yet.
019d846areject order
Rejects a pending order with a specific reason (e.g., out of stock) and logs the rejection event.
019d846arequest courier
Schedules an on-demand courier pickup for B2B deliveries, specifying both pick-up and drop-off addresses.
019d846atrack shipment
Monitors the real-time GPS location of a currently assigned courier shipment.
019d846aupdate product price
Immediately changes the price of any specific menu product visible on the public marketplace listing.
019d846aupdate product status
Toggles a menu item's availability (sold out or back online) without changing its core data.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with PedidosYa, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're talking to a teammate about how this thing works, right? Here’s the deal: PedidosYa MCP Server lets you run the whole show—from accepting orders to tracking couriers—through your AI agent. You don't need to touch that damn tablet anymore. This server gives your agent direct control over every part of a restaurant's operation across Latin America.
When it comes to Processing Orders, you can get an overview of pending, preparing, or ready orders using list_orders. If you wanna see the full scoop on one specific order, you run get_order and it pulls all the details and contents for that ID. If you're ready for it, calling accept_order commits the restaurant to prepare those items.
But if something's wrong—say, you ran out of stock—you use reject_order, specifying a reason so it gets logged correctly. You can also mark an order as finished with mark_order_ready; that automatically kicks off courier dispatch if one hasn't been assigned yet.
For Menu Management, the server handles real-time changes. If you need to update pricing, you run update_product_price and immediately change the price on the public marketplace listing for any item. When an item sells out, don't mess with the whole menu; just use update_product_status to toggle that specific product off or back online.
You can check what’s available in the first place by running list_menu_sections, which lists all categories and products, including their current prices and if they're available right now.
For Logistics, you control the movement of goods. When you need a courier for a B2B pickup, you use request_courier to schedule an on-demand pick-up, letting it know both the drop-off and the pick-up addresses. To track where that guy is right now, just run track_shipment, which monitors the real-time GPS location of the assigned courier.
On the Data Side, you get a handle on your physical locations. You can see an overview of all partner restaurant spots using list_restaurants and check each one's current open or closed status. If you need the detailed operational info for one specific spot, run get_restaurant. For automation, you set up automated webhooks with create_webhook, which alerts your agent when events happen like new orders or cancellations.
You can always review what hooks you've got running by checking list_webhooks.
Seriously, this setup lets your agent handle everything from accepting a rush order to tracking the guy who brings the pizza back—all without you lifting a finger.
How PedidosYa MCP Works
- 1 Subscribe to the server and provide your PedidosYa Partner Client ID and Secret.
- 2 Use your AI agent to execute a command (e.g., 'Check for pending orders').
- 3 The MCP Server runs the tool, processes the data against your account, and returns the status or required action to your agent.
The bottom line is that you manage complex delivery operations using simple conversational commands instead of navigating web portals.
Who Is PedidosYa MCP For?
This is for restaurant groups and kitchen operators who spend too much time manually managing orders, updating menus across multiple locations, or calling dispatch services. If you're tired of the physical tablet interface slowing down peak operations, this server handles the backend logistics.
Orchestrates multi-brand virtual kitchen workflows by programmatically accepting orders and updating inventory status for different brands.
Requests on-demand couriers using request_courier for non-order related pickups and monitors all movements with track_shipment.
Manages daily operations by accepting or rejecting orders via natural language, and updating product availability using update_product_status.
What Changes When You Connect
- Stop manually checking the POS tablet. Use
list_ordersto pull every pending request into your agent, letting you process dozens of orders from a single chat prompt. - Control inventory live. Instead of updating signage or calling staff, use
update_product_statusandupdate_product_priceto make items sold out or change costs instantly on the marketplace listing. - Handle logistics without relying on phone calls. You can initiate pickups with
request_courier, providing addresses and package details right from your agent interface. - Maintain full visibility into operations. Run
list_restaurantsto confirm every venue's status, or useget_restaurantto check specific operating hours before staff arrives. - Build automated alerts. Use
create_webhookto ensure your system gets instant notifications for new orders or cancellations, so you never miss a critical event.
Real-World Use Cases
The Rush Hour Order Triage
A manager sees the incoming order queue building up. They ask their agent to 'Check all pending orders'. The agent uses list_orders to pull three requests, then they use accept_order on two and reject_order on one because an ingredient ran out. All done in under 60 seconds.
The Urgent B2B Delivery
A restaurant needs to send supplies across town immediately. The manager doesn't use the regular order flow. They ask their agent to 'Send a courier from the kitchen to the supplier'. The agent runs request_courier and then uses track_shipment to monitor the pickup in real time.
End-of-Day Menu Cleanup
Staff finished running out of a key dessert. Instead of physically crossing it off a chalkboard, they ask their agent to 'Mark Chocotorta as sold out'. The agent uses update_product_status, and the change appears instantly on the live menu.
System Monitoring and Alerts
The system needs to track performance for compliance. Instead of logging into a dashboard, an engineer runs list_webhooks first, then uses get_restaurant for key metrics across all venues, keeping an auditable record.
The Tradeoffs
Treating it like general e-commerce API
Assuming that calling the server will also give me payment processing history or customer loyalty points.
→
This server focuses strictly on PedidosYa operations. Payment data and deep CRM records require separate integration, not just running get_order.
Ignoring status updates
Accepting an order without realizing the courier needs to be dispatched first.
→
After using accept_order, always consider following up with mark_order_ready if you need the system to trigger courier dispatch immediately.
Manual state tracking
Writing down which items are out of stock and updating them physically later.
→
Use update_product_status when an item sells out. This keeps the listing accurate right now.
When It Fits, When It Doesn't
Use this server if your core business challenge is managing high-volume, time-sensitive restaurant logistics specifically within the PedidosYa ecosystem in Latin America. You need to programmatically control order intake, menu visibility, and courier dispatch.
Don't use it if you only need basic product catalog management (use a general inventory API) or if your operations rely on payment gateway actions (use a dedicated payments tool). If you simply need to read static restaurant data without acting on orders, list_restaurants is enough, but for full operational control, this is required.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by PedidosYa. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 14 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Processing incoming orders shouldn't require hitting the physical tablet.
Right now, when an order comes in, someone has to physically check the partner tablet. If they are busy, or if the network lags, accepting a simple order means stopping what you’re doing, tapping through multiple menus, and confirming the details on a single screen. This is slow, and it's prone to human error.
With this MCP server, your AI agent handles the entire interaction. You just tell your agent, 'Accept pending orders for my top three dishes.' The system uses `list_orders` to find them and then executes `accept_order`, doing the heavy lifting in the background. It's instant.
PedidosYa MCP Server: Control inventory with `update_product_status`.
If you run out of a popular item—say, the Margherita pizza—today, you currently have to tell staff, who then has to manually go into the POS system and mark it 'Sold Out' across every single platform. If they forget that step, customers still see it and get frustrated.
Now, you just ask your agent to `update_product_status` for that item. The change is immediate and visible on the marketplace listing. You control inventory status programmatically.
Common Questions About PedidosYa MCP
How do I check if there are new orders using list_orders? +
You ask your agent to run list_orders. The tool filters and returns a clean, actionable list of pending requests, organized by status (e.g., 'Pending Acceptance,' 'Ready for Pickup').
Can I change the price using update_product_price? +
Yes. Running update_product_price changes the cost of a specific menu item instantly on your live PedidosYa listing, making it effective immediately for all customers.
What is the best way to handle webhooks with create_webhook? +
Use create_webhook when you need real-time alerts. You subscribe to specific events (like 'new_order' or 'order_cancelled'), and your agent gets notified immediately without needing constant polling.
How do I track a courier delivery with track_shipment? +
You must first use request_courier to get a shipment ID. Then, you run track_shipment using that ID; it streams the real-time GPS location of the assigned driver.
How does using `reject_order` impact my venue's standing? +
Rejecting an order requires a valid reason. The system warns that frequent rejections—like too many 'out_of_stock' reasons—can affect your restaurant’s ranking on the platform, so use this tool judiciously.
What specific data does `get_order` return for a pending delivery? +
It provides complete details for one order. You get all necessary information, including the list of items purchased and the total cost structure, without needing to look at multiple orders.
How do I view my full menu breakdown using `list_menu_sections`? +
This tool breaks your entire menu into its sections (like Entradas or Bebidas). It lists every product within those sections, along with current prices and availability status.
What happens when I call `mark_order_ready`? +
Marking an order as ready for pickup triggers the courier dispatch process. This action signals to PedidosYa that the food is prepared, initiating or confirming the arrival of a delivery courier.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Vouchery.io
Manage coupon, discount, and loyalty programs on Vouchery.io with AI agents.
Mercado Libre
Manage your Mercado Libre business via AI — list products, track orders, handle shipments, and answer buyer questions directly.
Mercado Pago
Process payments, generate Pix QR codes, manage customers and refunds via Mercado Pago API.
You might also like
Zoho Billing Alternative
Automate your subscription management with Zoho Billing — manage organizations, products, and plans directly from your AI agent.
GovInfo (GPO Legislative Docs)
Access official US government documents, legislative bills, and federal registers directly from the GPO.
Adyen
Global payment processing — manage payments, refunds, and merchant accounts via AI.