Skip to main content
Glama
umich-dining-mcp

umich-dining-mcp

by esreddy2

Get a dining hall menu

get_menu
Read-onlyIdempotent

Retrieve a University of Michigan dining hall menu with meals, stations, dishes, traits, allergens, and nutrients; defaults to the current or next meal and today's date.

Instructions

Get the menu of one dining hall: meals, stations and dishes. Rows: [name, traits, allergens, mhealthyTier, calories, servingSize, servingSizeGrams] plus nutrients. traits/allergens are codes; read key. With no meal, the meal being served now is returned (or next if closed). Date defaults to today; site publishes today-3..+14. stale means expired cache; asOf data age. Allergens advisory.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "hall": "<hall>"
    },
    "name": "get_menu"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateNoThe day to read. Defaults to today.
hallYesThe dining hall to read.
mealNoKeeps only those meals: one name, or a list of them. When it is left out, the meal the hall is serving right now is used.
stationNoKeeps only that station.
include_nutrientsNoNutrients to return, by key/name, or ["all"].

Output Schema

NameRequiredDescriptionDefault
keyYes
asOfNo
dateYes
hallYes
noteNo
mealsYes
staleYes
unitsNo
nutrientsNo
totalItemsYes
renderedDateNo
totalStationsYes
unknownMealLabelsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.0.0
    • 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"
      -]
  2. Changed23 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: +"The day to read. Defaults to today."
    • addedInput schema / properties / include_nutrients
      Added value: +{
      +  "description": "Nutrients to return, by key/name, or [\"all\"].",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / meal / anyOf
      Added value: +[
      +  {
      +    "enum": [
      +      "Breakfast",
      +      "Brunch",
      +      "Lunch",
      +      "Dinner"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "enum": [
      +        "Breakfast",
      +        "Brunch",
      +        "Lunch",
      +        "Dinner"
      +      ],
      +      "type": "string"
      +    },
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / meal / description
      Added value: +"Keeps only those meals: one name, or a list of them. When it is left out, the meal the hall is serving right now is used."
    • removedInput schema / properties / meal / enum
      Removed value: -[
      -  "Breakfast",
      -  "Lunch",
      -  "Dinner"
      -]
    • removedInput schema / properties / meal / type
      Removed value: -"string"
    • addedInput schema / properties / station
      Added value: +{
      +  "description": "Keeps only that station.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / asOf
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / hallName
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / key
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {
      +      "type": "string"
      +    },
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • removedOutput schema / properties / mealLabels
      Removed value: -{
      -  "additionalProperties": {
      -    "type": "string"
      -  },
      -  "propertyNames": {
      -    "type": "string"
      -  },
      -  "type": "object"
      -}
    • removedOutput schema / properties / meals / additionalProperties
      Removed value: -false
    • addedOutput schema / properties / meals / items
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "meal": {
      +      "maximum": 9007199254740991,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "stations": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "items": {
      +            "items": {
      +              "items": {
      +                "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"
      +                  }
      +                ]
      +              },
      +              "type": "array"
      +            },
      +            "type": "array"
      +          },
      +          "station": {
      +            "maximum": 9007199254740991,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "station",
      +          "items"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "meal",
      +    "stations"
      +  ],
      +  "type": "object"
      +}
    • removedOutput schema / properties / meals / properties
      Removed value: -{
      -  "Breakfast": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "items": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "allergens": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "carbonFootprint": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "low",
      -                      "medium",
      -                      "high"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "mhealthyTier": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "nutrition": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "calories": {
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "cholesterol": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "dietaryFiber": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "micronutrients": {
      -                        "additionalProperties": {
      -                          "type": "string"
      -                        },
      -                        "propertyNames": {
      -                          "type": "string"
      -                        },
      -                        "type": "object"
      -                      },
      -                      "protein": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "saturatedFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "servingSize": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sodium": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sugars": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalCarbohydrate": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "transFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "servingSize",
      -                      "calories",
      -                      "totalFat",
      -                      "saturatedFat",
      -                      "transFat",
      -                      "cholesterol",
      -                      "sodium",
      -                      "totalCarbohydrate",
      -                      "dietaryFiber",
      -                      "sugars",
      -                      "protein",
      -                      "micronutrients"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "traitLabels": {
      -                "additionalProperties": {
      -                  "type": "string"
      -                },
      -                "propertyNames": {
      -                  "type": "string"
      -                },
      -                "type": "object"
      -              },
      -              "traits": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "traits",
      -              "traitLabels",
      -              "allergens",
      -              "mhealthyTier",
      -              "carbonFootprint",
      -              "nutrition"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "name": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "name",
      -        "items"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "Dinner": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "items": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "allergens": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "carbonFootprint": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "low",
      -                      "medium",
      -                      "high"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "mhealthyTier": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "nutrition": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "calories": {
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "cholesterol": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "dietaryFiber": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "micronutrients": {
      -                        "additionalProperties": {
      -                          "type": "string"
      -                        },
      -                        "propertyNames": {
      -                          "type": "string"
      -                        },
      -                        "type": "object"
      -                      },
      -                      "protein": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "saturatedFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "servingSize": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sodium": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sugars": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalCarbohydrate": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "transFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "servingSize",
      -                      "calories",
      -                      "totalFat",
      -                      "saturatedFat",
      -                      "transFat",
      -                      "cholesterol",
      -                      "sodium",
      -                      "totalCarbohydrate",
      -                      "dietaryFiber",
      -                      "sugars",
      -                      "protein",
      -                      "micronutrients"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "traitLabels": {
      -                "additionalProperties": {
      -                  "type": "string"
      -                },
      -                "propertyNames": {
      -                  "type": "string"
      -                },
      -                "type": "object"
      -              },
      -              "traits": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "traits",
      -              "traitLabels",
      -              "allergens",
      -              "mhealthyTier",
      -              "carbonFootprint",
      -              "nutrition"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "name": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "name",
      -        "items"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "Lunch": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "items": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "allergens": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "carbonFootprint": {
      -                "anyOf": [
      -                  {
      -                    "enum": [
      -                      "low",
      -                      "medium",
      -                      "high"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "mhealthyTier": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "nutrition": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "calories": {
      -                        "type": [
      -                          "number",
      -                          "null"
      -                        ]
      -                      },
      -                      "cholesterol": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "dietaryFiber": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "micronutrients": {
      -                        "additionalProperties": {
      -                          "type": "string"
      -                        },
      -                        "propertyNames": {
      -                          "type": "string"
      -                        },
      -                        "type": "object"
      -                      },
      -                      "protein": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "saturatedFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "servingSize": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sodium": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "sugars": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalCarbohydrate": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "totalFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "transFat": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "servingSize",
      -                      "calories",
      -                      "totalFat",
      -                      "saturatedFat",
      -                      "transFat",
      -                      "cholesterol",
      -                      "sodium",
      -                      "totalCarbohydrate",
      -                      "dietaryFiber",
      -                      "sugars",
      -                      "protein",
      -                      "micronutrients"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "traitLabels": {
      -                "additionalProperties": {
      -                  "type": "string"
      -                },
      -                "propertyNames": {
      -                  "type": "string"
      -                },
      -                "type": "object"
      -              },
      -              "traits": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "traits",
      -              "traitLabels",
      -              "allergens",
      -              "mhealthyTier",
      -              "carbonFootprint",
      -              "nutrition"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "name": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "name",
      -        "items"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedOutput schema / properties / meals / required
      Removed value: -[
      -  "Breakfast",
      -  "Lunch",
      -  "Dinner"
      -]
    • changedOutput schema / properties / meals / type
      Previous value: -"object"New value: +"array"
    • addedOutput schema / properties / note
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / nutrients
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / renderedDate / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • addedOutput schema / properties / units
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / unknownMealLabels
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "hall",
      -  "hallName",
      -  "date",
      -  "mealLabels",
      -  "meals",
      -  "renderedDate",
      -  "totalStations",
      -  "totalItems",
      -  "stale"
      -]New value: +[
      +  "hall",
      +  "date",
      +  "key",
      +  "meals",
      +  "unknownMealLabels",
      +  "totalStations",
      +  "totalItems",
      +  "stale"
      +]
  3. First observedv0.1.0

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/openWorld, and the description adds non-obvious runtime semantics on top: the fallback-meal behavior, the cache/publish window, what 'stale' means, that asOf reflects data age, and that allergens are advisory only. That is exactly the extra context annotations cannot convey.

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?

Front-loaded with purpose, then row shape, then behavioral caveats — a sensible ordering with almost no filler. The telegraphic fragments ('stale means expired cache; asOf data age') are efficient but slightly clipped.

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

Completeness5/5

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

Output schema exists, yet the description still names the row fields and the nutrients payload and covers cache freshness and allergen caveats — everything an agent needs to interpret a response correctly for a 5-parameter read tool.

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

Parameters4/5

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

Schema coverage is 100%, so baseline is 3; the description still adds value by explaining the publication date window constraint and the meal-default behavior, plus how traits/allergens codes should be read via the key. It does not add syntax detail for station or include_nutrients beyond the schema.

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?

States a specific verb and resource ('Get the menu of one dining hall') and enumerates the payload (meals, stations, dishes), which separates it from list-oriented siblings like list_locations. It does not explicitly name filter_dishes as the alternative, so the differentiation is implied rather than stated.

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

Usage Guidelines4/5

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

Gives real operating guidance: meal is optional and falls back to the currently served meal (or next if closed), date defaults to today, and the site only publishes today-3..+14. It stops short of saying when to choose this over filter_dishes or get_item_nutrition.

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