Skip to main content
Glama
umich-dining-mcp

umich-dining-mcp

by esreddy2

Filter dishes

filter_dishes
Read-onlyIdempotent

Filter University of Michigan dining hall dishes by allergens, traits, nutrient ranges, carbon footprint, calories, sodium, and name to find menu items that meet specific dietary needs.

Instructions

Filter dining hall menus by allergen, trait, nutrient density, carbon, calories, sodium and name. All params optional. Allergens/traits are slugs; read key for codes. min_mhealthy: keep tiers >= (1-5). max_carbon: keep tiers <= (1 low, 2 medium, 3 high). nutrients: range per nutrient. query: case-insensitive substring. Rows are coded arrays; read key. stale means expired cache; asOf data age. Allergens advisory.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "filter_dishes"
  }
}

Input Schema

NameRequiredDescriptionDefault
toNoThe last day of a range to filter. Defaults to the last published day.
dateNoA single day to filter. Cannot be combined with from/to.
fromNoThe first day of a range to filter.
hallNoHalls: one, a list, or none for all.
mealNoKeeps only that meal.
limitNoRows to return (default 50, max 500).
queryNoA case-insensitive substring of the dish name.
offsetNoPages of the range to skip.
sort_byNoSort field: a nutrient key, carbonFootprint, a micronutrient name, servingSize, mhealthyTier, or a ratio "numerator:denominator" (e.g. "protein:calories", "vitaminA:iron"). Legacy: proteinToCalorie, fiberToCalorie.
stationNoKeeps only that station.
nutrientsNoRange per nutrient, e.g. {"protein":{"min":20,"unit":"g"}}. A constraint drops dishes with no value.
max_carbonNoThe highest acceptable carbon footprint: 1 (low), 2 (medium) or 3 (high). The dishes the site did not tag are dropped.
sort_orderNoThe direction of the sort. It defaults to desc, so the biggest value comes first.
min_mhealthyNoThe lowest acceptable nutrient-density tier. The dishes the site did not tag are dropped.
require_traitsNoKeeps only the dishes that carry every one of these traits.
exclude_allergensNoKeeps only the dishes that carry none of these allergens.
include_nutrientsNoNutrients to return, by key/name, or ["all"].

Output Schema

NameRequiredDescriptionDefault
keyYes
asOfNo
dateNo
noteNo
flagsNo
staleYes
unitsNo
filterNo
noMenuNo
matchesYes
coverageNo
failuresYes
dateRangeNo
nutrientsNo
truncatedYes
totalMatchesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv2.0.0
    • changedInput schema / properties / hall / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "bursley",
      -      "east-quad",
      -      "markley",
      -      "mosher-jordan",
      -      "north-quad",
      -      "south-quad",
      -      "twigs-at-oxford",
      -      "wolverine-village",
      -      "lawyers-club",
      -      "martha-cook"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "enum": [
      -        "bursley",
      -        "east-quad",
      -        "markley",
      -        "mosher-jordan",
      -        "north-quad",
      -        "south-quad",
      -        "twigs-at-oxford",
      -        "wolverine-village",
      -        "lawyers-club",
      -        "martha-cook"
      -      ],
      -      "type": "string"
      -    },
      -    "maxItems": 10,
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "maxItems": 10,
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / require_traits / items / enum
      Removed value: -[
      -  "carbonhigh",
      -  "carbonlow",
      -  "carbonmedium",
      -  "glutenfree",
      -  "halal",
      -  "kosher",
      -  "mhealthy1",
      -  "mhealthy2",
      -  "mhealthy3",
      -  "mhealthy4",
      -  "mhealthy5",
      -  "spicy",
      -  "vegan",
      -  "vegetarian"
      -]
  2. Changed46 schema fields changedv0.1.1
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / date / description
      Previous value: -"Calendar date in YYYY-MM-DD. The site publishes menus for today-3 days to today+14 days."New value: +"A single day to filter. Cannot be combined with from/to."
    • addedInput schema / properties / exclude_allergens / description
      Added value: +"Keeps only the dishes that carry none of these allergens."
    • addedInput schema / properties / from
      Added value: +{
      +  "description": "The first day of a range to filter.",
      +  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / hall / anyOf
      Added value: +[
      +  {
      +    "enum": [
      +      "bursley",
      +      "east-quad",
      +      "markley",
      +      "mosher-jordan",
      +      "north-quad",
      +      "south-quad",
      +      "twigs-at-oxford",
      +      "wolverine-village",
      +      "lawyers-club",
      +      "martha-cook"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "enum": [
      +        "bursley",
      +        "east-quad",
      +        "markley",
      +        "mosher-jordan",
      +        "north-quad",
      +        "south-quad",
      +        "twigs-at-oxford",
      +        "wolverine-village",
      +        "lawyers-club",
      +        "martha-cook"
      +      ],
      +      "type": "string"
      +    },
      +    "maxItems": 10,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / hall / description
      Added value: +"Halls: one, a list, or none for all."
    • removedInput schema / properties / hall / enum
      Removed value: -[
      -  "bursley",
      -  "east-quad",
      -  "markley",
      -  "mosher-jordan",
      -  "north-quad",
      -  "south-quad",
      -  "twigs-at-oxford",
      -  "wolverine-village",
      -  "lawyers-club",
      -  "martha-cook"
      -]
    • removedInput schema / properties / hall / type
      Removed value: -"string"
    • addedInput schema / properties / include_nutrients
      Added value: +{
      +  "description": "Nutrients to return, by key/name, or [\"all\"].",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / limit / description
      Added value: +"Rows to return (default 50, max 500)."
    • removedInput schema / properties / max_calories
      Removed value: -{
      -  "minimum": 0,
      -  "type": "number"
      -}
    • addedInput schema / properties / max_carbon / description
      Added value: +"The highest acceptable carbon footprint: 1 (low), 2 (medium) or 3 (high). The dishes the site did not tag are dropped."
    • removedInput schema / properties / max_carbon / enum
      Removed value: -[
      -  "low",
      -  "medium",
      -  "high"
      -]
    • addedInput schema / properties / max_carbon / maximum
      Added value: +3
    • addedInput schema / properties / max_carbon / minimum
      Added value: +1
    • changedInput schema / properties / max_carbon / type
      Previous value: -"string"New value: +"integer"
    • removedInput schema / properties / max_sodium_mg
      Removed value: -{
      -  "minimum": 0,
      -  "type": "number"
      -}
    • addedInput schema / properties / meal
      Added value: +{
      +  "description": "Keeps only that meal.",
      +  "enum": [
      +    "Breakfast",
      +    "Brunch",
      +    "Lunch",
      +    "Dinner"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / min_mhealthy / description
      Added value: +"The lowest acceptable nutrient-density tier. The dishes the site did not tag are dropped."
    • addedInput schema / properties / nutrients
      Added value: +{
      +  "additionalProperties": {
      +    "properties": {
      +      "max": {
      +        "description": "The highest acceptable value, in the unit below.",
      +        "type": "number"
      +      },
      +      "min": {
      +        "description": "The lowest acceptable value, in the unit below.",
      +        "type": "number"
      +      },
      +      "unit": {
      +        "description": "The unit of the bounds. It defaults to the nutrient's own; a micronutrient defaults to the published percent.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "description": "Range per nutrient, e.g. {\"protein\":{\"min\":20,\"unit\":\"g\"}}. A constraint drops dishes with no value.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "description": "Pages of the range to skip.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / query
      Added value: +{
      +  "description": "A case-insensitive substring of the dish name.",
      +  "type": "string"
      +}
    • addedInput schema / properties / require_traits / description
      Added value: +"Keeps only the dishes that carry every one of these traits."
    • addedInput schema / properties / sort_by
      Added value: +{
      +  "description": "Sort field: a nutrient key, carbonFootprint, a micronutrient name, servingSize, mhealthyTier, or a ratio \"numerator:denominator\" (e.g. \"protein:calories\", \"vitaminA:iron\"). Legacy: proteinToCalorie, fiberToCalorie.",
      +  "type": "string"
      +}
    • addedInput schema / properties / sort_order
      Added value: +{
      +  "description": "The direction of the sort. It defaults to desc, so the biggest value comes first.",
      +  "enum": [
      +    "asc",
      +    "desc"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / station
      Added value: +{
      +  "description": "Keeps only that station.",
      +  "type": "string"
      +}
    • addedInput schema / properties / to
      Added value: +{
      +  "description": "The last day of a range to filter. Defaults to the last published day.",
      +  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / asOf
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / coverage
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "cached": {
      +      "type": "number"
      +    },
      +    "failed": {
      +      "type": "number"
      +    },
      +    "fetchedNow": {
      +      "type": "number"
      +    },
      +    "nextOffset": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "offset": {
      +      "type": "number"
      +    },
      +    "pages": {
      +      "type": "number"
      +    },
      +    "pending": {
      +      "type": "number"
      +    },
      +    "requested": {
      +      "type": "number"
      +    },
      +    "stale": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "requested",
      +    "cached",
      +    "fetchedNow",
      +    "pending",
      +    "failed",
      +    "stale",
      +    "offset",
      +    "pages",
      +    "nextOffset"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / dateRange
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "from": {
      +      "type": "string"
      +    },
      +    "to": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "from",
      +    "to"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / filter
      Added value: +{
      +  "additionalProperties": {},
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / flags
      Added value: +{
      +  "additionalProperties": {},
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / key
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {
      +      "type": "string"
      +    },
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • removedOutput schema / properties / matches / items / additionalProperties
      Removed value: -false
    • addedOutput schema / properties / matches / items / items
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    },
      +    {
      +      "items": {
      +        "type": "number"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "additionalProperties": {
      +        "type": "number"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    }
      +  ]
      +}
    • removedOutput schema / properties / matches / items / properties
      Removed value: -{
      -  "allergens": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "calories": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "carbonFootprint": {
      -    "anyOf": [
      -      {
      -        "enum": [
      -          "low",
      -          "medium",
      -          "high"
      -        ],
      -        "type": "string"
      -      },
      -      {
      -        "type": "null"
      -      }
      -    ]
      -  },
      -  "date": {
      -    "type": "string"
      -  },
      -  "hall": {
      -    "enum": [
      -      "bursley",
      -      "east-quad",
      -      "markley",
      -      "mosher-jordan",
      -      "north-quad",
      -      "south-quad",
      -      "twigs-at-oxford",
      -      "wolverine-village",
      -      "lawyers-club",
      -      "martha-cook"
      -    ],
      -    "type": "string"
      -  },
      -  "hallName": {
      -    "type": "string"
      -  },
      -  "meal": {
      -    "enum": [
      -      "Breakfast",
      -      "Lunch",
      -      "Dinner"
      -    ],
      -    "type": "string"
      -  },
      -  "mhealthyTier": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": "string"
      -  },
      -  "sodiumMg": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "station": {
      -    "type": "string"
      -  },
      -  "traitLabels": {
      -    "additionalProperties": {
      -      "type": "string"
      -    },
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  },
      -  "traits": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedOutput schema / properties / matches / items / required
      Removed value: -[
      -  "hall",
      -  "hallName",
      -  "date",
      -  "meal",
      -  "station",
      -  "name",
      -  "traits",
      -  "traitLabels",
      -  "allergens",
      -  "mhealthyTier",
      -  "carbonFootprint",
      -  "calories",
      -  "sodiumMg"
      -]
    • changedOutput schema / properties / matches / items / type
      Previous value: -"object"New value: +"array"
    • addedOutput schema / properties / noMenu
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "date": {
      +        "type": "string"
      +      },
      +      "hall": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "hall",
      +      "date"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / nutrients
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / stale
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / units
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • removedOutput schema / properties / warning
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / required
      Previous value: -[
      -  "date",
      -  "totalMatches",
      -  "matches",
      -  "failures",
      -  "warning"
      -]New value: +[
      +  "key",
      +  "totalMatches",
      +  "truncated",
      +  "stale",
      +  "matches",
      +  "failures"
      +]
  3. First observedv0.1.0

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only, idempotent, non-destructive and open-world behavior, so the bar is lower, yet the description still adds real context: rows come back as coded arrays that require the key, 'stale' marks expired cache with asOf indicating data age, and allergen filtering is advisory rather than a safety guarantee. These are behavior-facing facts an agent cannot get from annotations or schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first sentence and the remaining telegraphic clauses cover 17 parameters in a compact block with little padding. Minor redundancy ('read key for codes' appears twice) and the fragment style cost it a point, but density is appropriate for the parameter count.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values needn't be explained, and the description does flag coded arrays and stale/asOf semantics. However, it leaves the 'key' reference ambiguous (presumably list_nutrition_fields), doesn't describe pagination interaction between limit/offset, and gives no indication of result size or ordering defaults beyond the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents all 17 parameters, and most description clauses (min_mhealthy tier semantics, max_carbon tier mapping, query substring) largely restate it. The one genuinely additive note is that allergens and traits are slugs requiring a key lookup for codes, which the schema does not convey for free-text trait values.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence names a specific verb (filter) and resource (dining hall menus) and enumerates the filterable dimensions, which is clearly distinct from retrieval-style siblings like get_menu or get_item_nutrition. It never explicitly names an alternative, but the 'filter' framing makes the role unambiguous to an agent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says 'All params optional' and notes 'Allergens advisory', but gives no guidance on when to choose this over get_menu or get_item_nutrition, and no exclusion or prerequisite conditions. The agent must infer usage from the name and parameter list alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.