Nutritional Database & Macro Search
Core food and nutrition search tool for AI agents. Retrieve exact protein, fat, carb, and calorie breakdown per 100g with micronutrient densities and allergen exclusion criteria.
Official NPM Package: dietspremium-mcp
Install the official DietsPremium MCP connector from the npm registry.
npm i dietspremium-mcp
npx -y dietspremium-mcp --auth "Bearer YOUR_MCP_SECRET"
Tool Argument Schema
Schema definition for the food tool.
| Argument | Type | Status | Default | Description |
|---|---|---|---|---|
| query | string | required | — | Food item (e.g. "grilled chicken breast", "avocado") |
| locale | string | optional | en | Language locale |
| proteins_min / proteins_max | integer | optional | 0 | Protein range in grams |
| kcal_min / kcal_max | integer | optional | 0 | Calorie range per 100g |
| allergen_exclude | string | optional | — | Comma-separated allergens to exclude |
| food_nutrient_include | string | optional | — | Required nutrient (e.g. "iron", "calcium") |
| ai | boolean | optional | true | AI semantic vector search |
MCP Client Configuration
Configure Claude Desktop, Cursor IDE, or direct JSON-RPC HTTP clients.
{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": [
"-y",
"dietspremium-mcp",
"--auth",
"Bearer YOUR_MCP_SECRET"
]
}
}
}{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": [
"-y",
"dietspremium-mcp",
"--auth",
"Bearer YOUR_MCP_SECRET"
]
}
}
}curl -X POST "https://www.dietspremium.com/_mcp" \
-H "Authorization: Bearer YOUR_MCP_SECRET" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "food",
"arguments": {
"query": "chicken breast",
"locale": "en",
"proteins_min": 25,
"kcal_max": 250,
"allergen_exclude": "gluten,lactose",
"max_results": 5,
"ai": true
}
}
}'JSON-RPC 2.0 tools/call Payload
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "food",
"arguments": {
"query": "chicken breast",
"locale": "en",
"proteins_min": 25,
"kcal_max": 250,
"allergen_exclude": "gluten,lactose",
"max_results": 5,
"ai": true
}
}
}Tool Execution Response
SUCCESS{
"content": [
{
"type": "text",
"text": "Food: Chicken Breast Raw (100g) - Calories: 165 kcal, Protein: 31.0g, Fat: 3.6g, Carbs: 0.0g. Allergens: None."
}
]
}Explore All MCP Tools
Direct documentation for all intelligence tools.
Allergen Risk & Intolerance Registry
Dietary allergens, cross-contamination risks, EU 1169/2011 allergen standards, and ingredient intolerance profiles.
Clinical Nutrition Guides & RAG Grounding
Search 6,000+ peer-reviewed nutrition articles, clinical guidelines, and wellness guides for agent grounding and citations.
Dietetic Catering & Clinic Directory
Search 173,000+ health clinics, dietetic catering providers, gyms, and wellness brands with geo-location metadata.
Exercise Biomechanics & Calorie Burn
Search 2,000+ workout exercises with targeted anatomical muscle groups, required equipment, and execution guidelines.
Nutritional Database & Macro Search
Search 1,900+ verified foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.
Pharmacology & Food-Drug Interactions
Database of 53,000+ active substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.
Culinary Recipes & Macro Balancing
Search 780+ chef-curated recipes with preparation steps, ingredients with gram weights, portion macronutrients, and difficulty levels.
Specialists & Certified Dietitians
Search verified clinical dietitians, sports nutritionists, and certified personal trainers for client assignment.
Supplements & Active Dosages
Dietary supplements catalog with active compound dosages, vitamin forms, and safety guidance.
Clinical & Lifestyle Diet Templates (158 Types)
Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.
Global Food Products & Barcodes (Open Food Facts + USDA)
Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.
Clinical Knowledge & Dietetic Grounding
Clinical nutrition guidelines, scientific dietary facts, medical definitions, and evidence-based grounding.