How to Use the iFood MCP in Windsurf

Q: How does Windsurf Cascade handle multiple iFood stores at once?

Cascade starts by invoking getstores to map out all active merchant IDs. It then processes each store sequentially, fetching orders or updating menus without needing individual prompts for each location.

Q: Can I ask Windsurf to auto-assign drivers for pending iFood orders?

Yes. Cascade chains getorders to find pending deliveries, fetches logistics details, and executes assigndriver to dispatch your fleet in a single autonomous execution.

Q: What happens if Cascade encounters an invalid order status?

Cascade catches the API error from updateorderstatus, reads the error payload, and corrects the transition path. It won't attempt illegal state jumps like moving a pending order straight to dispatched.

Run your entire iFood restaurant operations autonomously with Windsurf and Cascade chaining menu updates and driver assignments.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect iFood MCP to Windsurf

Create your Vinkius account to connect iFood to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup iFood with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Step Dispatch Loops in Windsurf

The `assign_driver` tool lets Cascade coordinate order fulfillment across your delivery fleet without stopping for manual input. Windsurf plans the logical sequence to find ready orders, check logistics, and dispatch drivers in one autonomous run. When a rush hits, Cascade reads the active orders, pulls delivery information, and assigns drivers. You set the end goal of clearing the queue, and the agent executes the required MCP tool calls sequentially.

Autonomous Catalog Syncing via this MCP Server

The `update_catalog_item` tool modifies pricing, availability, and descriptions across your stores based on live inventory inputs. Windsurf scans your local files, identifies menu discrepancies, and updates the remote iFood catalog directly. Cascade handles the entire update loop by fetching the current menu structure and applying targeted changes. You don't have to copy-paste IDs or run manual updates for each item.

Dynamic Operational Hour Management

The `update_business_hours` tool modifies operating schedules for any store in your merchant account when holiday hours or sudden closures occur. Windsurf reads your local calendar files and translates those dates into the required JSON schedule structure. Cascade verifies the changes against your current hours before executing the update. The agent flags scheduling conflicts automatically before pushing the new hours live.

Setup guide

Set up iFood MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the iFood MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my iFood payment history." If connected, Cascade will call the iFood tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ifood-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by iFood. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect iFood now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about iFood MCP in Windsurf

Cascade starts by invoking `get_stores` to map out all active merchant IDs. It then processes each store sequentially, fetching orders or updating menus without needing individual prompts for each location.

Yes. Cascade chains `get_orders` to find pending deliveries, fetches logistics details, and executes `assign_driver` to dispatch your fleet in a single autonomous execution.

You point Cascade to a spreadsheet or text file with new pricing. The agent reads the local data, matches items against the menu structure from `get_catalog`, and calls `update_catalog_item` to push changes live.

Cascade catches the API error from `update_order_status`, reads the error payload, and corrects the transition path. It won't attempt illegal state jumps like moving a pending order straight to dispatched.

Your order logs and customer details stay inside the secure V8 sandbox. This MCP connection uses token-based authentication to route commands, ensuring sensitive order details and delivery addresses never leak to external servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript