@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