How to Use the USDA FoodData Central MCP in OpenAI Agents SDK

Q: How can I search for nutritional profiles using USDA FoodData Central and the OpenAI Agents SDK?

Simply use the searchusdafoods tool. You just need to provide keywords, and the agent returns a list of matching foods from the USDA FoodData Central database. It includes key metrics like calories and protein for every serving.

Q: What if I need specific details for one food item using USDA FoodData Central and OpenAI Agents SDK?

For deep dives, use getusdafooddetails. You pass a single USDA FDC ID to this tool, and it returns the complete nutritional profile. This is better than searching if you already know the exact identifier.

Get precise nutritional data from USDA FoodData Central using your OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect USDA FoodData Central to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find food profiles by ID

Need deep details on a specific item? Use the `get_usda_food_details` tool to pull comprehensive nutrient info using only the USDA FDC ID. This gives you everything—it’s fast and reliable. If your agent needs to verify if an ingredient is high in sugar or low in fiber, this function handles it. It delivers structured data so your subsequent actions don't run into garbage inputs.

Search the 300k food database

The `search_usda_foods` tool lets you query over 300,000 USDA foods at once. You get a quick snapshot of calories, protein, fat, carbs, fiber, and sugar per serving. This search covers everything from basic ingredients to major branded products found in the database. It’s built for agents that need broad market coverage without manual lookups.

Structure complex data workflows

Your agent system can chain operations using this MCP Server. After searching with `search_usda_foods`, it can pass the resulting IDs to `get_usda_food_details` for deeper analysis. This kind of multi-step process is what makes your deployment robust. The OpenAI Agents SDK handles the handoffs, making sure every piece of data flows correctly through your custom logic.

Setup guide

Set up USDA FoodData Central MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all USDA FoodData Central tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives USDA FoodData Central tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate USDA FoodData Central tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="USDA FoodData Central Agent",
            instructions="You have access to USDA FoodData Central tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Simply use the `search_usda_foods` tool. You just need to provide keywords, and the agent returns a list of matching foods from the USDA FoodData Central database. It includes key metrics like calories and protein for every serving.

Absolutely. The MCP Server provides the raw data, but your agent uses the built-in guardrails to validate that data before any action is taken. It ensures you're working with clean records from the USDA FoodData Central.

For deep dives, use `get_usda_food_details`. You pass a single USDA FDC ID to this tool, and it returns the complete nutritional profile. This is better than searching if you already know the exact identifier.

The server provides access to nutrient profiles, including calories, protein, fat, carbs, fiber, and sugar. It draws from a massive dataset that covers both foundation foods and branded products.

This server touches public nutritional profile data drawn from the U.S. Department of Agriculture's database, specifically nutrient metrics associated with food items and their IDs.

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