Skip to content
MCP server

Usda MCP Server

Search foods, compare nutrients, and look up the full USDA FoodData Central database.

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.2.2
Listing updated
4 days ago

About Usda MCP Server

Usda MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add --transport http usda-mcp-server https://usda.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://usda.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "usda-mcp-server": {
      "url": "https://usda.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "usda-mcp-server": {
      "type": "http",
      "url": "https://usda.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "usda-mcp-server": {
      "serverUrl": "https://usda.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "usda-mcp-server": {
      "type": "http",
      "url": "https://usda.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • USDA_FDC_API_KEYUSDA FoodData Central API key from data.gov. Required for all food data requests.Required
  • USDA_CLAMP_LIMITSWhen true, usda_get_foods fetches the first 20 distinct FDC IDs of a larger request and returns the rest as deferredIds; false rejects a request with more than 20 IDs.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • USDA_FDC_API_KEYUSDA FoodData Central API key from data.gov. Required for all food data requests.Required
  • USDA_CLAMP_LIMITSWhen true, usda_get_foods fetches the first 20 distinct FDC IDs of a larger request and returns the rest as deferredIds; false rejects a request with more than 20 IDs.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Usda MCP Server FAQ

Is Usda MCP Server free?

Yes. Usda MCP Server is open source, so you can use and self-host it for free.

How do I add Usda MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http usda-mcp-server https://usda.caseyjhand.com/mcp