Usda MCP Server

by cyanheadsio.github.cyanheads/usda-mcp-serverv0.1.11

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

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active18d ago

Install Usda MCP server

claude mcp add usda -e USDA_FDC_API_KEY='<usda-fdc-api-key>' -- npx -y @cyanheads/usda-mcp-server run start:stdio

{
  "mcpServers": {
    "usda": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usda-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "USDA_FDC_API_KEY": "<usda-fdc-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "usda": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usda-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "USDA_FDC_API_KEY": "<usda-fdc-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "usda": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usda-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "USDA_FDC_API_KEY": "<usda-fdc-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "usda": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usda-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "USDA_FDC_API_KEY": "<usda-fdc-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
USDA_FDC_API_KEY	yes	—	USDA FoodData Central API key from data.gov. Required for all food data requests.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Remote endpoints

streamable-httphttps://usda.caseyjhand.com/mcp

Freshness

Active — last maintenance signal 18d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-22 · 18d ago · GitHub
Latest release
2026-09-22 · 18d ago · GitHub · v0.1.11
Package published
no data · npm/PyPI
Registry entry updated
2026-09-22 · 18d ago · official registry · v0.1.11

FAQ

›How do I install the Usda MCP server in Claude Code?

Run: claude mcp add usda -e USDA_FDC_API_KEY='<usda-fdc-api-key>' -- npx -y @cyanheads/usda-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Usda require an API key?

Yes. It expects USDA_FDC_API_KEY.

›Can I use Usda as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Usda in the official MCP registry?

Yes, as io.github.cyanheads/usda-mcp-server.