PedidosYa MCP. Manage order flow and courier logistics instantly.
PedidosYa MCP automates your entire restaurant operation across Latin America's leading food delivery platform. Manage incoming orders, adjust menus on the fly, and dispatch couriers—all through natural conversation with any AI client.
Give Claude and any AI agent real-world access
Receive and act on incoming orders by accepting them for preparation, rejecting them with a reason, or marking them as ready for pickup.
Instantly update pricing or toggle products on or off so customers only see what you actually have in stock right now.
Schedule on-demand couriers for package pickups and track their real-time location until the delivery is complete.
View operational details, including all registered restaurant locations and their current business hours.
Ask an AI about this
Waiting for input…
What AI agents can do with PedidosYa with 14 Tools
These tools give you direct access to key functions like order status checks, menu adjustments, and courier dispatching for full control over your delivery business.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using PedidosYa MCPAccept Order
Accepts a pending customer order, signaling to the system that your kitchen is preparing the items for pickup.
Update Product Price
Changes the listed price of any menu item, with the update taking effect immediately...
Update Product Status
Toggles a product's availability online, marking it sold out or bringing it back to...
Create Webhook
Sets up event-driven webhooks so your systems automatically react when things like...
Get Order
Retrieves the complete details for a specific customer order using an identifier.
Get Restaurant
Fetches operational data and status information for a particular registered restaurant location.
List Menu Sections
Gets a full list of menu categories and all products within them, including current pricing and availability.
List Orders
Lists incoming orders, allowing you to filter by status—pending, being prepared, or...
List Restaurants
Shows a list of all your partner restaurant venues, including their operational...
List Webhooks
Displays all the webhook event subscriptions you have currently configured.
Mark Order Ready
Triggers the courier dispatch process for an order, assuming a delivery courier...
Reject Order
Declines an incoming customer order and provides a specific reason like 'out of stock' or 'too busy'.
Request Courier
Schedules an on-demand courier pickup for external deliveries, specifying both the starting and ending addresses.
Track Shipment
Provides real-time GPS coordinates and status updates for a currently active courier...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each 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 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Managing restaurant operations used to be a mess of clicking through tabs.
Today, accepting orders requires opening the tablet app, finding the pending queue, tapping each order one by one, and confirming acceptance. If you run out of a popular side item, you have to navigate deep into the menu structure, find that specific product listing, and toggle it off so customers don't try ordering it—all while juggling other tasks.
With this MCP, the same process happens in plain English. You just tell your agent: 'Accept all pending orders,' or 'Mark out-of-stock items.' The platform does the mechanical work, giving you immediate control without touching a single screen.
PedidosYa MCP gives you instant menu and order management.
The manual steps that vanish are logging into multiple platforms to check inventory, manually updating prices after cost changes, or waiting for a dispatcher call when an order is ready. You lose the physical dependency on the Point of Sale terminal.
Now, your entire operation runs through natural language prompts. It’s immediate, comprehensive control over every stage, from menu listing via `list_menu_sections` to final delivery tracking using `track_shipment`. Period.
What PedidosYa MCP does for your AI
Managing a popular restaurant means juggling more than just cooking; you're running logistics, marketing, and inventory simultaneously. This MCP lets you treat your PedidosYa partner account like an extension of your mind. You can receive new orders and instantly accept or reject them without ever touching the physical tablet. Need to mark items as sold out because you ran low? Do it in real-time on your live menu listing.
It goes deeper than just order status: you can even request a courier for internal B2B deliveries and track their exact GPS location until they arrive at your kitchen door.
If you're looking for reliable, multi-platform control over high-volume delivery operations in Latin America, Vinkius hosts this MCP so you connect once to manage everything. You can even set up automated webhooks that fire when cancellations happen or new orders come in, keeping your systems always updated.
019d846a-acca-707e-ba12-3b0468d4dd1a How to set up PedidosYa MCP
The bottom line is you use natural language prompts to execute complex operational tasks that normally require logging into a separate portal and clicking through multiple screens.
Subscribe to this MCP using your PedidosYa Partner Client ID and Secret.
Connect the credentials to your AI client (like Claude or Cursor).
Ask your agent to perform an action, such as listing all pending orders or requesting a courier.
Who uses PedidosYa MCP
This MCP is essential for restaurant owners, dark kitchen operators, and logistics managers running multi-site or high-volume operations. If your current process requires manual tablet interaction to handle basic flow (like accepting orders or adjusting stock), you need this.
Uses the MCP to accept incoming customer orders and mark items sold out when they run low, all without physically touching the Point of Sale tablet.
Orchestrates multi-brand virtual kitchen operations by programmatically managing menu updates across various physical venues.
Requests on-demand courier pickups for B2B deliveries and monitors the entire shipment journey in real time using this MCP.
Benefits of connecting PedidosYa MCP
Accept and manage orders using the list_orders tool. Instead of clicking through a tablet interface, you simply ask your agent to process all pending deliveries in natural language.
You maintain full menu control by using update_product_status. If an item sells out, mark it unavailable immediately so customers don't place orders for things you don't have.
Handle last-mile logistics with the request_courier tool. Schedule pickups and track shipments in real time using track_shipment, keeping your inventory flowing smoothly.
Keep your data pipelines running by setting up webhooks via create_webhook. This ensures that when a cancellation happens, your internal systems are instantly notified without needing manual checks.
Adjust pricing on the fly. The update_product_price tool lets you change menu costs immediately, making sure your online listing always matches your current financial model.
PedidosYa MCP use cases
Handling a sudden rush of orders
A manager notices 15 new pending orders. Instead of logging into the tablet and hitting 'Accept' fifteen times, they prompt their agent: 'Review all pending orders and accept them for preparation.' The MCP handles the accept_order sequence instantly.
Coordinating a multi-site inventory check
A dark kitchen operator needs to know which brand's menu items are sold out across three different locations. They ask for a full list of menu sections, and the agent runs list_menu_sections on each venue to confirm stock levels before going live.
Emergency courier pickup
A logistics manager needs parts picked up from a client's site across town. They tell their agent: 'Request a courier for a package pick-up at X address and drop off at Y address.' The MCP handles the request_courier call, giving them a tracking ID.
Addressing pricing discrepancies
The finance team realizes the price of their flagship dish is wrong online. They tell the agent to 'Update the price for the main course' using update_product_price, ensuring the marketplace listing reflects the correct cost immediately.
PedidosYa MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Only checking order status
A user only asks, 'What orders do I have?' and then gets a list. They are left to manually check if items need price updates or if they need to request couriers.
To get the full picture, you must combine calls. Ask your agent: 'List all pending orders, check their status, and let me know if any courier pickups are needed.' This uses list_orders combined with request_courier.
Manually updating menus
A staff member has to log in, navigate through multiple menu categories, and manually toggle the status of sold-out items one by one.
Use update_product_status or list_menu_sections. Tell your agent: 'Mark all products under the Appetizer section as unavailable.' This saves hours of clicking.
Ignoring delivery logistics
The kitchen finishes an order and waits for a courier to show up, manually calling the dispatch line when they are ready.
Instead, tell your agent: 'Mark Order #1234 as ready.' This triggers mark_order_ready, initiating the automated courier assignment process.
When to use PedidosYa MCP
Use this MCP if your business needs programmatic control over the entire order and delivery lifecycle on PedidosYa. You need to handle real-time state changes, like accepting a sudden influx of orders or instantly marking products sold out based on inventory counts. However, don't use this if your only goal is simple reporting; for historical data retrieval across all venues, you might just need list_restaurants and get_restaurant. Also, if you only manage basic payments and don't care about courier tracking or menu status, a simpler payment gateway MCP will suffice. But when order flow, inventory control (update_product_status), and physical logistics are intertwined, this is your tool.
Frequently asked questions about PedidosYa MCP
How do I accept an order using the PedidosYa MCP? +
You use the accept_order tool. Simply tell your agent to 'Accept all pending orders' and it executes the necessary steps, committing you to preparing the items.
Can I update prices with the PedidosYa MCP? +
Yes, use the update_product_price tool. You provide the menu product ID and the new local currency price, and it updates instantly on the live listing.
What is the best way to track a delivery with PedidosYa MCP? +
Use the track_shipment tool. You input the shipment ID provided when you run request_courier, and the agent gives you real-time GPS updates on the courier's location.
How do I handle sold out items with PedidosYa MCP? +
Use update_product_status. You specify the product ID, and it toggles the item off the menu instantly. This is much faster than manually editing the menu listing.
Can I set up automatic alerts for new orders with PedidosYa MCP? +
Yes, you use create_webhook. You specify events like 'new_order' or 'order_cancelled,' and your systems will automatically get notified when those things happen.
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.