# Rappi API MCP for AI Agents AI Agent Connect > Rappi API lets you automate the heavy lifting of Latin America's largest delivery super-app. Use your AI agent to track live courier locations, manage merchant orders, and handle customer support tickets without jumping between different mobile screens or manual dashboards. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_P1SHShqowHle7Ot3vfERU2RoJGqR0C0dErN4H2qh/ai-agent-connect - **Tags:** delivery-services, hyper-local, logistics-tracking, courier-management, last-mile-delivery ## Description You're dealing with the complexity of regional logistics across Latin America. Instead of toggling between browser tabs and mobile apps to see where a delivery is or if a store is still open, this Connector puts that data directly into your AI's hands. You can have your agent monitor order statuses, ping couriers, or handle missing item disputes automatically. It handles the messy work of parsing local market data and restaurant menus so you can focus on the bigger picture. Because Vinkius makes it easy to connect these tools, you can plug in your credentials and start running these operations as part of your existing AI workflow. It's about moving from manual checking to having things handled. ## Tools ### get_store_availability Check if a specific store is currently taking orders. This is helpful for verifying merchant status before sale. ### get_order_handoff Get the specific codes needed to confirm a handoff. This ensures the courier actually delivered the items. ### get_store_menu Pull the complete list of items and prices from a store. This keeps your local data accurate and updated. ### get_order_detail See every piece of information for a specific order. This is useful for checking current status and history. ### list_stores View all the stores currently registered under your account. This helps you manage a multi-location portfolio. ### mark_ready_for_pickup Tell the courier that the order is ready to be grabbed. This speeds up the handoff process for your kitchen. ### take_order Accept a new order and start the preparation process. This is the primary way to begin your fulfillment workflow. ### update_store_status Toggle your store's status to open or closed for new orders. Use this to manage your business hours instantly. ### list_new_orders See which orders are waiting for you to accept them. Use this to monitor your incoming queue in real-time. ### reject_order Turn down an incoming order and provide a reason why. This keeps your queue clean of unfulfillable requests. ## Prompt Examples **Prompt:** ``` Can you see if the pharmacy near me is still open and what's on their menu? ``` **Response:** ``` I've checked the local area for you. **Pharmacies Found:** * **Farmatodo** (Store ID: f_91) * **Status:** Open * **Delivery Fee:** $1.50 (Dynamic) * **Menu Highlights:** Painkillers, first-aid supplies, vitamins. Would you like me to pull the full inventory list for Farmatodo? ``` **Prompt:** ``` What's the status of order 8812920 and where is the courier? ``` **Response:** ``` ### Order 8812920 Status * **Current State:** Out for Delivery * **Courier Location:** 1.2 km away * **Estimated Arrival:** 6 minutes * **Notes:** Courier is moving smoothly with no reported delays. Do you want me to authorize a tip for the driver? ``` **Prompt:** ``` I need to cancel order 88910 because some items are missing. Can you do that? ``` **Response:** ``` ### Order Cancellation I've sent the request to cancel order **88910**. * **Reason:** Items Missing against receipt * **Status:** Successfully Aborted * **Refund:** The refund algorithm has been triggered. Credits will be added to your vault shortly. Would you like me to draft a formal complaint to the merchant? ``` ## Capabilities ### Track courier locations See exactly where your delivery is in real-time with live geographic coordinates. ### Monitor incoming orders Get alerted to new orders waiting for acceptance without manual refreshing. ### Update store status Toggle your store's open or closed status instantly via your agent. ### Retrieve live menus Pull current food items and pricing directly from merchant endpoints. ### Automate order cancellations Abort orders and trigger refund processes for missing items or errors. ### Analyze market pricing Poll local store data to build comparative pricing and stock dashboards. ## Use Cases ### Corporate Catering Management An office manager uses list_new_orders to see incoming food for a large meeting and take_order to confirm the delivery. ### Real-Time Market Analysis A retail analyst uses get_store_availability and get_store_menu to build a live price comparison map of a city's pharmacies. ### Automated Support Resolution A customer service rep uses get_order_detail to identify missing items and reject_order to trigger an automatic refund. ### Logistics Bottleneck Mapping An urban planner uses get_order_handoff to verify courier completion times across different traffic zones and hubs. ## Benefits - Track couriers live with get_order_detail to see exactly where your package is in the delivery chain. - Manage high-volume orders with take_order and reject_order to keep your fulfillment workflow moving. - Update your business status instantly using update_store_status to control your order flow without a dashboard. - Pull accurate data with get_store_menu to keep your inventory and pricing up to date automatically. - Handle customer issues faster with get_order_handoff to verify successful deliveries and close tickets. - Monitor your entire merchant portfolio with list_stores to manage multiple locations from one place. ## How It Works The bottom line is that you turn complex REST endpoints into simple commands your AI can execute. 1. Get developer approval from the Rappi Developer Hub. 2. Extract your Client ID and Client Secret from your account. 3. Plug those variables into the Connector to start running commands. ## Frequently Asked Questions **Can the Rappi API MCP help manage my restaurant orders?** Yes. It allows your agent to accept, reject, and monitor all incoming orders for your restaurant automatically, so you don't have to stay glued to a dashboard. **How does the Rappi API MCP track courier locations?** The Connector pulls live geographic coordinates from the delivery network. Your agent can use this to give you real-time updates on exactly where a courier is located. **Can I use the Rappi API MCP to check store availability?** Yes. You can ask your agent to check if specific stores are currently open or accepting orders before you try to place a request. **Does the Rappi API MCP support order cancellations?** It does. Your agent can initiate cancellations and provide reasons, such as missing items, which can help trigger automatic refund processes. **Can I pull live menus with the Rappi API MCP?** Yes. You can retrieve the full, current menu of any store, including items and pricing, to ensure your data is always accurate. **Is the Rappi API MCP good for market research in Latin America?** It's excellent for this. You can use your agent to poll multiple stores for pricing and stock data to build comparative market dashboards. **Does order placement via the API bypass the normal Rappi checkout security rules?** No. The `place_order` tool uses your pre-authenticated method securely. Bank validations, anti-fraud algorithms, and location checks apply exactly as they would natively in the application avoiding compliance breaches entirely. **Can I explicitly track multiple concurrent active orders dynamically simultaneously?** Yes! Your agent can iterate over an array of active Order IDs using the `get_order_status` tool consistently. It parses coordinate updates and ETA drops, outputting a consolidated table summing up your entire inbound fleet seamlessly. **Are the store identifiers (storeId) universally stable across regions?** Store IDs are fundamentally unique keys generated explicitly by Rappi's catalog backend. They remain static for the lifetime of that specific branch location. Searching via `list_nearby_stores` initially is recommended to cache the correct target IDs dynamically.