How to Use the USDA FoodData Central MCP in Windsurf

Q: Can I find macro details for branded products using USDA FoodData Central and Windsurf?

Absolutely. First, you search the database with searchusdafoods. This step finds the product ID. Then, the MCP Server runs getusdafooddetails to get specific fat, carb, and sugar counts.

Chain complex nutrition lookups across your workflow with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect USDA FoodData Central MCP to Windsurf

Create your Vinkius account to connect USDA FoodData Central 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 USDA FoodData Central with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run multi-step food data queries using the MCP Server

Start by calling `search_usda_foods` to get an overview of 300,000+ foods. Cascade handles the next steps: it takes a list of IDs and runs `get_usda_food_details` for each one. You set the goal—the MCP Server figures out the sequence.

Process branded product nutrition records

Need to know the exact macros for specific packaged goods? Use `search_usda_foods` first, filtering by brand data. Then, you can call `get_usda_food_details` using the resulting USDA FDC ID. It pulls scientific-grade nutrient profiles directly into your context.

Compare nutritional values across different food types

`search_usda_foods` gives you quick access to calories, protein, fat, carbs, fiber, and sugar for foundational foods. You can then compare these general metrics against a specific item's full profile by invoking `get_usda_food_details`. Windsurf runs the whole comparison automatically.

Setup guide

Set up USDA FoodData Central 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 USDA FoodData Central 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 USDA FoodData Central payment history." If connected, Cascade will call the USDA FoodData Central tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "usda-fooddata-central-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 USDA. 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 USDA FoodData Central 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 USDA FoodData Central MCP in Windsurf

You give Windsurf a goal like, 'Find all protein content for these five items.' The MCP Server handles the search and then calls `get_usda_food_details` on every item. It returns clean data ready to use.

Absolutely. First, you search the database with `search_usda_foods`. This step finds the product ID. Then, the MCP Server runs `get_usda_food_details` to get specific fat, carb, and sugar counts.

The server accesses 300,000+ current food entries from the U.S. Department of Agriculture. While you can't search for 'last year's' data, you get comprehensive nutrient profiles for all foundation foods and branded products available now.

It provides scientific-grade nutritional information. You'll get detailed fields covering calories, protein, fat, carbs, fiber, and sugar per serving for any food item.

This MCP Server deals with publicly available nutritional profiles. The specific data type is structured nutrient records (e.g., protein, fat). It doesn't touch any personal user information.

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