Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,071Paid calls: 1,536Letters: 14Defects: 1,322counted just now
teppi

Server definition

Hash
sha256:04231003dabaf19c4928efffec57d488df9cfa2d91ac5f476c489782fb010ae7
What it is
What a remote MCP server returned when asked what it offers: 5 tools

The blob, as servednamed by its sha256

{ "instructions": "USDA FoodData Central (FDC) — authoritative US food composition database (~400K+ foods). Key workflow: usda_search_foods → fdcId → usda_get_food (single), usda_get_foods (batch), or usda_compare_foods (comparison). Use usda_list_nutrients to resolve nutrient names to numeric IDs before filtering.", "tools": [ { "description": "Compare nutrients side-by-side for 2–5 foods. Returns a structured table — one row per nutrient, one column per food — formatted as markdown. Best for \"spinach vs kale iron\" or \"which has more protein?\" questions. Omit nutrients[] to use the 12 most common defaults (energy, protein, fat, saturated fat, carbs, fiber, sugars, sodium, potassium, calcium, iron, vitamin C); provide nutrients[] with specific FDC IDs to compare different nutrients. All values are scaled to the same gram basis (default 100g). If one or more FDC IDs are not found, the comparison proceeds with the valid foods — only throws too_few_foods when fewer than 2 IDs return data.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "fdcIds": { "description": "FDC IDs to compare — 2 to 5 foods. Use usda_search_foods to discover IDs.", "items": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "maxItems": 5, "minItems": 2, "type": "array" }, "nutrients": { "description": "Nutrient IDs to include in the comparison. Defaults to the 12 most common: energy (1008), protein (1003), total fat (1004), saturated fat (1258), carbohydrate (1005), fiber (1079), total sugars (2000), sodium (1093), potassium (1092), calcium (1087), iron (1089), vitamin C (1162). Use usda_list_nutrients to look up other IDs.", "items": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": "array" }, "quantity": { "default": 100, "description": "Gram basis for comparison. All values scaled to this amount. Must be positive. Default 100.", "exclusiveMinimum": 0, "type": "number" }, "unit": { "default": "g", "description": "Unit for quantity. Default \"g\". Does not support \"serving\" (use a fixed gram basis for consistent comparison).", "enum": [ "g", "oz", "lb", "kg" ], "type": "string" } }, "required": [ "fdcIds" ], "type": "object" }, "name": "usda_compare_foods", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "basis", "foods", "nutrients" ] }, { "required": [ "error" ] } ], "properties": { "basis": { "additionalProperties": false, "description": "The common scaling basis applied to all nutrient values.", "properties": { "gramWeight": { "description": "Gram weight resolved from quantity+unit — all nutrient values are per this many grams.", "type": "number" }, "quantity": { "description": "Numeric quantity provided in the request.", "type": "number" }, "unit": { "description": "Unit provided in the request (g, oz, lb, or kg).", "type": "string" } }, "required": [ "quantity", "unit", "gramWeight" ], "type": "object" }, "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode. Declared by this tool: `too_few_foods`: Fewer than 2 of the provided FDC IDs returned data, making comparison impossible. Other values are possible when a failure originates below the handler.", "examples": [ "too_few_foods" ], "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "foods": { "description": "The compared foods, in the same order as the values arrays below.", "items": { "additionalProperties": false, "description": "One of the compared foods.", "properties": { "dataType": { "description": "FDC data source: SR Legacy, Foundation, Survey (FNDDS), or Branded.", "type": "string" }, "description": { "description": "Full USDA food name (e.g. \"Spinach, raw\").", "type": "string" }, "fdcId": { "description": "FDC ID.", "type": "number" } }, "required": [ "fdcId", "description", "dataType" ], "type": "object" }, "type": "array" }, "missingData": { "description": "Foods or food+nutrient pairs where data was unavailable. Absent when all data was present.", "items": { "additionalProperties": false, "description": "A food or food+nutrient pair where data was unavailable.", "properties": { "fdcId": { "description": "FDC ID that had missing data.", "type": "number" }, "nutrientId": { "description": "Nutrient ID that was missing, or null when the entire food was not found.", "type": [ "number", "null" ] } }, "required": [ "fdcId", "nutrientId" ], "type": "object" }, "type": "array" }, "nutrients": { "description": "Nutrient rows — one entry per requested nutrient, with per-food values in the values[] array.", "items": { "additionalProperties": false, "description": "One nutrient row with per-food values.", "properties": { "id": { "description": "FDC nutrient ID.", "type": "number" }, "name": { "description": "Nutrient name (e.g. \"Protein\", \"Energy\").", "type": "string" }, "unit": { "description": "Measurement unit (e.g. \"G\", \"MG\", \"KCAL\").", "type": "string" }, "values": { "description": "One value per food in the same order as foods[]. null when data is unavailable for that food.", "items": { "type": [ "number", "null" ] }, "type": "array" } }, "required": [ "id", "name", "unit", "values" ], "type": "object" }, "type": "array" } }, "type": "object" } }, { "description": "Get the full nutrient profile for one food by FDC ID. Returns all available nutrients (or a filtered subset via the nutrients[] param) with optional per-portion scaling. Use usda_search_foods to discover FDC IDs. Provide quantity + unit to scale all nutrient values from per-100g to the specified portion (e.g. quantity=200, unit=\"g\" → per-200g values). Use unit=\"serving\" to scale to the food's first defined portion weight. Narrow nutrients[] to specific IDs to reduce response size for focused queries.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "fdcId": { "description": "FDC ID of the food. Use usda_search_foods to discover IDs.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "nutrients": { "description": "Filter to specific nutrient IDs (e.g. [1003, 1004, 1005, 1008] for protein, fat, carbs, energy). Use usda_list_nutrients to look up IDs. Omit to return all available nutrients.", "items": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": "array" }, "quantity": { "description": "Amount of food to scale nutrient values to. Must be positive. When provided, unit is required. Omit for per-100g values (FDC database native basis).", "exclusiveMinimum": 0, "type": "number" }, "unit": { "description": "Unit for quantity. \"serving\" uses the food's first defined portion weight. Required when quantity is provided.", "enum": [ "g", "oz", "lb", "kg", "serving" ], "type": "string" } }, "required": [ "fdcId" ], "type": "object" }, "name": "usda_get_food", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "fdcId", "description", "dataType", "nutrients" ] }, { "required": [ "error" ] } ], "properties": { "allPortions": { "description": "All named portions for this food.", "items": { "additionalProperties": false, "description": "A named portion for this food.", "properties": { "description": { "description": "Portion description.", "type": "string" }, "gramWeight": { "description": "Gram weight of this portion.", "type": "number" } }, "required": [ "description", "gramWeight" ], "type": "object" }, "type": "array" }, "brandName": { "description": "Brand name. Branded items only.", "type": "string" }, "brandOwner": { "description": "Brand owner. Branded items only.", "type": "string" }, "dataType": { "description": "FDC data source: SR Legacy, Foundation, Survey (FNDDS), or Branded.", "type": "string" }, "description": { "description": "Full USDA food name (e.g. \"Chicken, broilers or fryers, breast, meat only, raw\").", "type": "string" }, "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode. Declared by this tool: `not_found`: The FDC ID does not exist in the database. `quantity_without_unit`: quantity is provided but unit is omitted. `no_portion_data`: unit=\"serving\" was requested but the food has no portion data. Other values are possible when a failure originates below the handler.", "examples": [ "not_found", "quantity_without_unit", "no_portion_data" ], "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "fdcId": { "description": "FDC ID of the food.", "type": "number" }, "foodCategory": { "description": "USDA food category (e.g. \"Poultry Products\"). Absent for some branded items.", "type": "string" }, "ingredients": { "description": "Ingredient list from label. Branded items only.", "type": "string" }, "nutrients": { "description": "Nutrient values for this food, per 100g or scaled to the requested quantity.", "items": { "additionalProperties": false, "description": "A single nutrient entry with ID, name, amount, and unit.", "properties": { "amount": { "description": "Nutrient amount — per 100g, or scaled to quantity+unit if provided.", "type": "number" }, "id": { "description": "FDC nutrient ID.", "type": "number" }, "name": { "description": "Nutrient name (e.g. \"Protein\", \"Energy\", \"Iron, Fe\").", "type": "string" }, "number": { "description": "SR reference number (legacy identifier).", "type": "string" }, "percentDailyValue": { "description": "Percent daily value from product label. Branded items only.", "type": "number" }, "unit": { "description": "Measurement unit (e.g. \"G\", \"MG\", \"KCAL\").", "type": "string" } }, "required": [ "id", "name", "number", "amount", "unit" ], "type": "object" }, "type": "array" }, "publicationDate": { "description": "Date this food entry was published in FDC.", "type": "string" }, "scaledTo": { "additionalProperties": false, "description": "Scaling basis when quantity+unit were provided. Absent when returning per-100g values.", "properties": { "gramWeight": { "description": "Gram weight resolved from quantity+unit — all nutrient values are per this many grams.", "type": "number" }, "quantity": { "description": "Numeric quantity provided in the request.", "type": "number" }, "unit": { "description": "Unit provided in the request (g, oz, lb, kg, or serving).", "type": "string" } }, "required": [ "quantity", "unit", "gramWeight" ], "type": "object" }, "servingInfo": { "additionalProperties": false, "description": "First available portion definition, if present.", "properties": { "description": { "description": "Portion description (e.g. \"1 cup\", \"4 oz\").", "type": "string" }, "gramWeight": { "description": "Gram weight of this portion.", "type": "number" } }, "required": [ "description", "gramWeight" ], "type": "object" } }, "type": "object" } }, { "description": "Fetch nutrient profiles for 2–20 foods in a single API call. More efficient than calling usda_get_food N times when you already have multiple FDC IDs. All values are per 100g (no portion scaling). Use the nutrients[] filter to limit response size — strongly recommended for batch calls. For side-by-side comparison with a formatted table, use usda_compare_foods instead. Failed IDs (not found or no data) are reported in the failed[] array rather than aborting the entire batch.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "fdcIds": { "description": "FDC IDs to fetch — 2 to 20 IDs. Use usda_search_foods to discover IDs.", "items": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "maxItems": 20, "minItems": 2, "type": "array" }, "nutrients": { "description": "Filter to specific nutrient IDs (e.g. [1003, 1004, 1005, 1008]). Strongly recommended — full profiles can be large. Use usda_list_nutrients to look up IDs.", "items": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "type": "array" } }, "required": [ "fdcIds" ], "type": "object" }, "name": "usda_get_foods", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "foods", "failed" ] }, { "required": [ "error" ] } ], "properties": { "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode.", "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "failed": { "description": "IDs that returned no data. Check these with usda_search_foods to verify they exist.", "items": { "additionalProperties": false, "description": "A failed food fetch with the FDC ID and error reason.", "properties": { "error": { "description": "Why this ID failed — not found, no data returned, etc.", "type": "string" }, "fdcId": { "description": "FDC ID that could not be fetched.", "type": "number" } }, "required": [ "fdcId", "error" ], "type": "object" }, "type": "array" }, "foods": { "description": "Successfully fetched foods.", "items": { "additionalProperties": false, "description": "Nutrient profile for one food.", "properties": { "dataType": { "description": "FDC data source: SR Legacy, Foundation, Survey (FNDDS), or Branded.", "type": "string" }, "description": { "description": "Full USDA food name (e.g. \"Chicken, broilers or fryers, breast, meat only, raw\").", "type": "string" }, "fdcId": { "description": "FDC ID of this food.", "type": "number" }, "nutrients": { "description": "Nutrient values per 100g.", "items": { "additionalProperties": false, "description": "A nutrient entry with ID, name, amount, and unit.", "properties": { "amount": { "description": "Amount per 100g.", "type": "number" }, "id": { "description": "FDC nutrient ID.", "type": "number" }, "name": { "description": "Nutrient name.", "type": "string" }, "number": { "description": "SR reference number.", "type": "string" }, "unit": { "description": "Measurement unit (e.g. \"G\", \"MG\", \"KCAL\").", "type": "string" } }, "required": [ "id", "name", "number", "amount", "unit" ], "type": "object" }, "type": "array" } }, "required": [ "fdcId", "description", "dataType", "nutrients" ], "type": "object" }, "type": "array" } }, "type": "object" } }, { "description": "Look up the FDC nutrient reference table — all tracked nutrients with their numeric IDs, names, SR reference numbers, units, and categories. Use to resolve a nutrient name (e.g. \"vitamin C\") to its FDC ID (1162) before passing it to the nutrients[] filter on other tools. Filter by category (macronutrients, vitamins, minerals, lipids, amino_acids, or other) to narrow results. The data is static — call once and reuse the IDs.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "description": "Filter to a nutrient category. Omit to return all ~150 tracked nutrients. Options: macronutrients, vitamins, minerals, lipids, amino_acids, other.", "enum": [ "macronutrients", "vitamins", "minerals", "lipids", "amino_acids", "other" ], "type": "string" } }, "type": "object" }, "name": "usda_list_nutrients", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "nutrients" ] }, { "required": [ "error" ] } ], "properties": { "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode.", "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "nutrients": { "description": "Nutrient reference entries matching the requested category, or all if category is omitted.", "items": { "additionalProperties": false, "description": "A nutrient reference entry with ID, name, unit, and category.", "properties": { "category": { "description": "Nutrient category grouping.", "type": "string" }, "id": { "description": "FDC nutrient ID — pass this to nutrients[] params on other tools.", "type": "number" }, "name": { "description": "Human-readable nutrient name (e.g. \"Protein\", \"Iron, Fe\").", "type": "string" }, "number": { "description": "SR reference number (legacy identifier, e.g. \"203\").", "type": "string" }, "unit": { "description": "Measurement unit (e.g. \"G\", \"MG\", \"UG\", \"KCAL\").", "type": "string" } }, "required": [ "id", "name", "number", "unit", "category" ], "type": "object" }, "type": "array" } }, "type": "object" } }, { "description": "Search USDA FoodData Central foods by keyword. Returns matching foods with FDC IDs and a preview of key nutrients (energy, protein, fat, carbs — not guaranteed complete). Use the returned fdcId with usda_get_food for the full nutrient profile, or usda_compare_foods for side-by-side comparisons. When dataType is omitted, defaults to SR Legacy (common whole foods with complete profiles) — or to Branded when brandOwner is set, since only Branded records carry one. Set dataType to [\"Branded\"] for packaged products, or include a UPC/GTIN code as the query. Pass brandOwner (e.g. \"General Mills\") to narrow branded results.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "brandOwner": { "description": "Filter branded results by brand owner name (e.g. \"General Mills\", \"Kraft\"). Only Branded records carry one, so setting this defaults dataType to [\"Branded\"] unless dataType is given explicitly.", "type": "string" }, "dataType": { "description": "FDC data sources to search. Omitting this defaults to [\"SR Legacy\"] (common whole foods, complete nutrient profiles), or to [\"Branded\"] when brandOwner is set. Include \"Branded\" for packaged products. Multiple values allowed.", "items": { "enum": [ "SR Legacy", "Foundation", "Survey (FNDDS)", "Branded" ], "type": "string" }, "type": "array" }, "foodCategory": { "description": "Filter by USDA food category (e.g. \"Poultry Products\", \"Vegetables and Vegetable Products\"). Case-sensitive.", "type": "string" }, "pageNumber": { "default": 1, "description": "Page number (1-based). Use with totalPages to paginate.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "pageSize": { "default": 10, "description": "Number of results per page. Default 10, maximum 50.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Search terms — food name, ingredient, or UPC/GTIN code for branded products. Examples: \"chicken breast raw\", \"banana\", \"012345678901\".", "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "usda_search_foods", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "totalHits", "currentPage", "totalPages", "foods", "totalCount" ] }, { "required": [ "error" ] } ], "properties": { "currentPage": { "description": "Current page number (1-based).", "type": "number" }, "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode. Declared by this tool: `query_empty`: The query is empty or contains only whitespace. `no_results`: No foods matched the query in the specified data sources. Other values are possible when a failure originates below the handler.", "examples": [ "query_empty", "no_results" ], "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "foods": { "description": "Foods matching the search query.", "items": { "additionalProperties": false, "description": "A food item matching the search query.", "properties": { "brandName": { "description": "Brand name. Present for Branded items only.", "type": "string" }, "brandOwner": { "description": "Brand owner name. Present for Branded items only.", "type": "string" }, "dataType": { "description": "FDC data source: SR Legacy, Foundation, Survey (FNDDS), or Branded.", "type": "string" }, "description": { "description": "USDA food description (e.g. \"Chicken, broilers or fryers, breast, meat only, raw\").", "type": "string" }, "fdcId": { "description": "FDC ID — pass to usda_get_food, usda_get_foods, or usda_compare_foods.", "type": "number" }, "foodCategory": { "description": "USDA food category (e.g. \"Poultry Products\"). Absent for some branded items.", "type": "string" }, "householdServingFullText": { "description": "Serving description as it appears on the label (e.g. \"1 cup\", \"1 oz\"). Branded only.", "type": "string" }, "nutrients": { "description": "Preview nutrients per 100g — typically energy, protein, fat, carbs for SR Legacy. Not a complete profile; use usda_get_food for the full set.", "items": { "additionalProperties": false, "description": "A preview nutrient entry with ID, name, and amount per 100g.", "properties": { "amount": { "description": "Amount per 100g.", "type": "number" }, "id": { "description": "FDC nutrient ID.", "type": "number" }, "name": { "description": "Nutrient name.", "type": "string" }, "unit": { "description": "Unit (e.g. \"G\", \"MG\", \"KCAL\").", "type": "string" } }, "required": [ "id", "name", "amount", "unit" ], "type": "object" }, "type": "array" }, "publishedDate": { "description": "Date the food entry was published in FDC.", "type": "string" }, "servingSize": { "description": "Serving size in grams from the product label. Branded only.", "type": "number" }, "servingSizeUnit": { "description": "Unit for servingSize (usually \"g\"). Branded only.", "type": "string" } }, "required": [ "fdcId", "description", "dataType", "nutrients" ], "type": "object" }, "type": "array" }, "totalCount": { "description": "Total foods matching the query across all pages.", "type": "number" }, "totalHits": { "description": "Total number of foods matching the query across all pages.", "type": "number" }, "totalPages": { "description": "Total number of pages available.", "type": "number" } }, "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:04231003dabaf19c4928efffec57d488df9cfa2d91ac5f476c489782fb010ae7 | sha256sum