@forkbit/mcp

@forkbit/mcp

Official Model Context Protocol server for the Forkbit API. Gives AI agents direct access to food search, nutrition parsing, and recipe analysis.

Install & run

FORKBIT_API_KEY=fkb_live_... npx @forkbit/mcp

Get an API key from your Forkbit dashboard. The server communicates over stdio and exits immediately with a clear error if FORKBIT_API_KEY is missing.

Optional: FORKBIT_BASE_URL overrides the API base URL (defaults to https://api.forkbit.io), useful for pointing at a local or staging API during development.

Claude Desktop setup

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "forkbit": {
      "command": "npx",
      "args": ["-y", "@forkbit/mcp"],
      "env": {
        "FORKBIT_API_KEY": "fkb_live_..."
      }
    }
  }
}

Tools

Tool	What it does	Credit cost
search_foods	Search the food database by name	1 per call
get_food	Full nutrient/portion detail for one food by id	1 per call
batch_get_foods	Full detail for up to 50 food ids in one call	1 per id
parse_nutrition	Parse a free-text food/meal description into nutrition	10 per call
analyze_recipe	Analyze a full recipe into total and per-serving nutrition	10 per ingredient line (max 50)

Every tool description in the server itself states expected latency and when to prefer it over a sibling tool. Read those in your MCP client for the full guidance an agent sees.

Links

• Forkbit API docs
• Contact support

License

MIT