umich-dining-mcp
Use this MCP server to answer live University of Michigan dining questions and inspect menus, nutrition, hours, allergens, and occupancy.
List the ten dining halls with contact/address details, daily service periods, open-now status, and gluten-free pantry availability.
Get a hall’s menu by date, meal, and station, including dishes, coded traits/allergens, nutrient-density tier, calories, serving size, and optional nutrients.
Search dishes by name across halls and dates, or filter by allergens, traits, nutrient ranges, calories, sodium, carbon footprint, nutrient-density tier, meal, and station.
List supported nutrition fields, units, alternative threshold units, and Daily Value bases for micronutrients.
Get daily service hours plus regular weekly schedules, and find which halls are open at a given or current campus-local time.
Get a full nutrition panel for one dish, including traits, allergens, tier, carbon footprint, and nutrition values.
Check real-time occupancy for sensor-equipped dining halls.
Use live cached data with stale/failure reporting, range-query coverage, and allergen advisory notes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@umich-dining-mcp Which dining halls are open right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
umich-dining-mcp
An MCP server for the dining halls of the University of Michigan in Ann Arbor. It answers what is being served, which dishes are vegan or halal, what a dish contains, how many calories it has, and when each hall is open.
Every answer is read live from dining.umich.edu. Pages are kept in memory for a few minutes so that ten questions cost one visit, but nothing is written to disk and no menu is mirrored.
Transports | Local stdio and hosted Streamable HTTP |
Runtime | Node.js 20.18.1 or newer |
Halls | the ten dining halls |
Registry |
Install
npm install -g umich-dining-mcpor run it without installing anything:
npx -y umich-dining-mcpClaude Code
claude mcp add umich-dining -- npx -y umich-dining-mcpCursor
~/.cursor/mcp.json:
{
"mcpServers": {
"umich-dining": {
"command": "npx",
"args": ["-y", "umich-dining-mcp"]
}
}
}VS Code
.vscode/mcp.json:
{
"servers": {
"umich-dining": {
"type": "stdio",
"command": "npx",
"args": ["-y", "umich-dining-mcp"]
}
}
}Any other client that starts MCP servers over stdio takes the same mcpServers entry as
Cursor, with npx -y umich-dining-mcp as the command.
Related MCP server: nutrition-mcp-server
Tools
Tool | What it does |
| The ten halls with address, phone, e-mail, map link, today's service periods, whether they are open right now, and whether they have a gluten-free pantry. |
| The menu of one hall for the meal it is serving right now: meals, stations and dishes, with the coded traits and allergens, the density and carbon tiers, the calories and the serving size. Name one meal or several to get them instead. |
| Find dishes by name, in the halls that are named or across all of them (case-insensitive substring match), on one day or over a range. |
| Filter the menus by allergen, trait, nutrient density, carbon footprint, nutrients, calories and sodium, in the halls that are named or across all of them, on one day or over a range. |
| The supported nutrient names, their units and the Daily Value basis of the micronutrients. |
| The service periods of a day plus the regular weekly schedule. A hall that cannot be read is reported in |
| Which halls are serving at a given time of day. |
| The full nutrition panel of a single dish. |
Resources
Resource | Content |
| The hall registry as JSON, with the code of every hall. |
| The 15 allergens and 14 traits with their codes and display labels, the trait implication closure and the allergen caveat. |
Example questions
What is serving at Bursley for dinner tonight?
Which halls are open right now?
Find vegan dishes at South Quad that do not contain soy.
What are the ingredients of the Oatmeal at Bursley? How many calories?
When is Markley open on Saturday?
Show me dishes with more than 500 mg of sodium.
Which halls serve tiramisu between the 24th and the 26th?The response contract
The rows of search_dishes and filter_dishes carry small integers instead of names, and a
key block at the top of the response maps every code back to its slug. The key lists only
what that response uses. The codes are frozen for the life of the contract.
{
"key": { "halls": { "1": "bursley" }, "meals": { "3": "Lunch" },
"stations": { "7": "Grill" }, "traits": { "5": "vegan" },
"allergens": { "7": "milk" } },
"units": { "calories": "kcal", "protein": "g" },
"note": "Allergen codes: check key.allergens before reporting; site data is advisory.",
"date": "2026-10-21",
"matches": [
[1, 3, 7, "Grilled Chicken", [5], [7], 3, 320, "1 Each (113g)", 113, 32]
]
}A row is an array; its fixed positions are named in each tool description and the
variable nutrient tail is carried once per response as nutrients. The member names of a
named row are two and a half times the data of the row, repeated on every row: a named row
cost 216 bytes, an array row costs 72.
The halls are 1..10 in the order of the registry below, the meals are 1 (Breakfast), 2 (Brunch), 3 (Lunch) and 4 (Dinner), the allergens are 1..15 and the six boolean traits are 1..6 (glutenfree, halal, kosher, spicy, vegan, vegetarian). A meal label the site invents takes the next free code, from 5. The stations have a frozen vocabulary too: the same station carries the same code in every response, so a code can be remembered.
mhealthyTieris 1 (Nutrient Dense Low) to 5 (Nutrient Dense High). The scale is fixed and described in the tool descriptions and inumich://taxonomy.A row carries the carbon tier (
carbonFootprint) only when the call constrains it withmax_carbonor sorts bycarbonFootprint; otherwise it is left out to keep the row small.The
traitsarray carries the six boolean traits only; the density tier is lifted into its own numeric field.The
unitsmap gives the unit of every nutrient the response returns. A micronutrient is an amount like every other nutrient: the site publishes the percent of the Daily Value, and the row carries the amount that percent stands for — 15 %DV of an 18 mg Daily Value of iron is2.7in mg. The percent is still available under its own name,%DV, in a threshold.A search or a filter takes the halls it covers: one hall, several halls, or no hall at all for every one of them. The rows come back in the order that was asked for, and
limittakes the first of them: the default is 50 rows, and the answer says how many matched and how to see the rest.The row always carries the calories and the serving size. Every other nutrient, the sodium included, is asked for by name with
include_nutrients— the sodium has nothing that makes it more interesting than the protein. A nutrient a filter constrained is always returned, whether or not it was asked for.A single-day response carries
date; a range response carriesdateRangeand each row carries thedatesit appeared on.A dish without a published value is reported as
null, never as zero. Atraceor a<value is not a value at all.
get_menu and the sweep tools return the same compact row, so a row means the same thing
wherever it is read. get_item_nutrition is the tool that returns the raw nutrition panel,
of one dish.
A whole menu is far smaller this way: the menu of South Quad went from 60,266 bytes to
8,817, and the menu of Bursley from 42,141 to 6,573. The panel of a single dish is one
call to get_item_nutrition.
The halls
id | Hall | id | Hall |
| Bursley |
| South Quad |
| East Quad |
| Twigs at Oxford |
| Markley |
| Wolverine Village |
| Mosher-Jordan |
| Lawyers Club |
| North Quad |
| Martha Cook |
The id is what get_menu, get_hours and search_dishes expect. The code of a hall is
its position in this list, counted from one.
Dates
The site publishes menus from three days ago to fourteen days ahead. Outside that range the site does not answer with an error, it answers with a different day's menu, so a date outside the range is refused before anything is fetched, with a message that names the range the site offers. When the page states which day it rendered, that day is compared with the one you asked for and a mismatch is an error rather than a wrong answer.
A range is asked for with from and to; to omitted means the last published day. The
two cannot be combined with date. A range that does not fit in one call is read in
windows with offset; the coverage block of the answer names the offset of the next
window.
Time
Every time the server reports is campus time: the time zone of Ann Arbor,
America/Detroit, which is Eastern Standard Time and Eastern Daylight Time in the summer.
The day the site publishes, the mealtimes, and the "today" of a cache entry are all read in
that zone.
The zone of the machine the server runs on does not matter. A server in Chicago and a server
in UTC answer the same question the same way, and the test suite checks that by running the
meal selection under several host zones. Set UMICH_DINING_TIMEZONE only to point the
server at a mirror of the site in another zone.
Filters
Parameter | Meaning |
| Keeps only the dishes that do not carry any of the listed allergens. |
| Keeps only the dishes that carry every listed trait. |
| Minimum nutrient-density tier, 1..5 (3 = "Nutrient Dense Medium or better"). |
| Maximum carbon footprint: |
| A range per nutrient, e.g. |
| The nutrients to return, by canonical key or by published name, or |
| A case-insensitive substring of the dish name. |
| Narrow the sweep to one meal or one station. |
| The field to sort on and the direction. |
A constraint on a nutrient excludes the dishes that publish no value for it: an unknown value is never a zero.
The cost of a range
A range query reads one page per hall per day, and the site is fetched at most two pages a
second. A query that needs more upstream pages than UMICH_DINING_MAX_RANGE_FETCHES
(default 12) returns the rows it could serve and a coverage block that says how much was
served:
"coverage": { "requested": 30, "cached": 18, "fetchedNow": 12, "pending": 0, "failed": 0,
"stale": 0, "offset": 0, "pages": 30, "nextOffset": null }The numbers add up: every page the query asked for was cached, fetched, left pending or
failed. nextOffset is where the rest of the range begins, so a wide range is read in
windows: ask again with offset set to that number.
The persistent cache exists for this: the pages of the published window are kept on disk and warmed in the background, so a range query is usually served without touching the site.
Allergens
Allergen data is only as good as the site. The menu page flags the allergens the kitchen reported for a dish, but it does not distinguish "contains" from "may contain", there are no ingredient lists, and a missing flag is not an absence of the allergen. The site's own guidance is: "Look for the signs posted near each food serving area for a list of menu options with allergens highlighted in red." "Gluten Free" means the dish is made without gluten, not that it is safe for someone with coeliac disease. Dedicated gluten-free pantries exist at South Quad, East Quad, Mosher-Jordan and Bursley.
The caveat is in the description of every tool that returns allergen data and in
umich://taxonomy. A response that carries allergens repeats one line reminding the reader
to resolve the codes; the long caveat is not repeated in every body. No tool ever claims
that a dish is safe.
Two further points about the traits, because the site is careful about them: a vegan dish is reported as vegetarian as well, since the site keeps the two apart, and no other trait implies another (halal does not imply vegetarian, and neither does kosher).
Configuration
Environment variable | Default | Meaning |
|
| The User-Agent to use. |
|
| The site to read. |
|
| The time zone of the campus: the day the site publishes and the mealtimes are read in it. |
|
| Per-request timeout. |
|
| Retries after the first attempt. |
|
| Requests in flight. |
|
| Minimum gap between requests. |
|
| Cache lifetime of today's menu. |
|
| Cache lifetime of a future menu. |
|
| Cache lifetime of a past menu. |
|
| Cache lifetime of the weekly schedule. |
|
| Upstream pages a single range query may fetch. |
|
| The persistent cache. |
|
| How long a cache entry is kept. |
|
| The largest the persistent cache may grow. |
|
| How often the persistent cache is pruned. |
How it treats the site
dining.umich.edu is somebody else's website, so the server stays gentle with it:
Two requests in flight, 500 ms apart at most. The limit is global to the process.
A cache with in-flight de-duplication. Ten questions about the same hall cost one request. Today's menu is cached for 15 minutes, a future menu for 6 hours, a past menu for 24 hours and the weekly hours for 24 hours.
Stale on error. If the site cannot be reached and a cached copy exists, the copy is served and marked as stale instead of failing the question.
One User-Agent. The site answers HTTP 200 to a small set of clients only;
python-requests/2.32.3is the one that has been measured to work, while a generic fetch agent and a headless browser both get 403. It is not the server's real identity, which is why it is configurable.
Occupancy
get_dining_occupancy reports real-time fullness for the halls that carry
sensors (Bursley, East Quad, South Quad, Mosher-Jordan, Twigs at Oxford):
{ "hall": "bursley" }It returns the current count, daily patron flow, total capacity, percent full, and the time of the reading. A hall with no sensor is simply omitted.
Short forms
Hall names, nutrients, and traits accept short, case-insensitive aliases:
Halls:
mojo,south,east,lawyers,cook,twigs,wovlerine, ...Nutrients:
cals,kcals,carbs,fiber,protein/prot,na/salt, ...Traits:
gf,veg.
Descriptions are unchanged; the server resolves the alias before validating.
Data source
Menus, hours, locations, nutrition, and occupancy are read from the U-M dining mobile API, with the public site scraper retained as a fallback. Answers are still read live and cached for a few minutes.
Contributing
Pull requests are welcome. The test suite, the fixtures and the release process are described in CONTRIBUTING.md.
License
MIT, see LICENSE.
Available Tools
8 toolsfilter_dishesFilter dishesBRead-onlyIdempotentInspect
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.
Inputs: to, date, from, hall, +13 more. Returns: key, asOf, date, note, +12 more
find_open_nowFind halls that are open nowARead-onlyIdempotentInspect
The dining halls that are serving at the given time of day, and the ids of the ones that are not, with the service periods of the day for the halls that are open. Without arguments the current campus-local time is used, and the response says which time it resolved. open carries the hall details and today's periods; closed carries hall ids only. stale means a page was served from an expired cache entry; asOf is the age of the data.
Inputs: at, date. Returns: at, asOf, date, open, +2 more
get_dining_occupancyDining hall occupancyARead-onlyIdempotentInspect
Real-time occupancy for monitored dining halls: current count, patron flow, total capacity, and percent full. Only halls with sensors are returned.
Inputs: hall. Returns: readings, observedAt
get_hoursGet dining hall hoursARead-onlyIdempotentInspect
Get the service periods published for a dining hall on the requested day, plus the regular weekly schedule. Accepts one hall, a list, or none for all (like filter_dishes). today is the day's published service periods and regular is the weekly schedule. A hall that cannot be read is reported in the failures and the other halls are still returned. The response carries the weekday name of the requested date. stale means the data is from cache and may be slightly old, but is still the best available; asOf is the age. Re-call only if you need guaranteed-fresh data.
Inputs: date, hall. Returns: asOf, date, halls, weekly, +2 more
get_item_nutritionGet a dish nutrition panelARead-onlyIdempotentInspect
Get the full nutrition panel of one dish. Name matched case-insensitively; exact match wins, else unique substring. Dish row uses the same coded layout as the sweep tools. Panel values are numbers with one units map; micronutrient amount is the derived amount, with the published percent behind it. asOf data age. Allergens advisory. Use this only when you need the full panel for a single dish. For multiple dishes, use filter_dishes with include_nutrients instead.
Inputs: hall (required), item (required), date, meal, +1 more. Returns: key, asOf, date, hall, +10 more
list_locationsList dining hallsARead-onlyIdempotentInspect
List the dining halls and their service periods for the day, with whether they are open now. openNow is evaluated at the current campus-local time. The entries are the halls and their service periods for the day. stale means a page was served from an expired cache entry; asOf is the age of the data. Cafes, markets, bakeries, grills, prices and meal plans are out of scope.
Inputs: date, hall. Returns: date, failures, locations, mapUrlTemplate
list_nutrition_fieldsList nutrition fieldsARead-onlyIdempotentInspect
List the canonical nutrient identifiers, their units, the alternative units a threshold may be written in, and the Daily Value basis of the published micronutrients. A constraint on a nutrient excludes the dishes that publish no value for it, and a value the site writes as "trace" or "< 1%" is missing rather than zero. sortFields includes servingSize, mhealthyTier and ratio syntax "a:b".
Inputs: no named parameters. Returns: notes, fields, sortFields, acceptedUnits, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Three tools (list_locations, get_hours, find_open_now) all return halls with service periods, and their boundaries rely on subtle distinctions like openNow vs. time-of-day filtering vs. weekly schedule. get_menu vs filter_dishes and get_item_nutrition vs list_nutrition_fields are better separated thanks to explicit cross-references in the descriptions, but the hours/location cluster remains overlapping.
All eight tools follow a consistent snake_case verb_noun pattern (get_menu, list_locations, filter_dishes, find_open_now), with verb choice reflecting intent (get for single-resource, list for enumeration, filter/find for queries). No naming style mixing.
Eight tools is well-scoped for a dining-hall domain: menu retrieval, filtering, hours, locations, occupancy, and nutrition each get focused coverage without redundancy in count. No tool feels like filler.
The surface covers menus, filtering, nutrition fields/panels, hours, location status, and occupancy, with cafes/markets/prices explicitly declared out of scope. Minor gaps: no multi-hall raw menu retrieval (only filter_dishes sweep) and dish lookup is name-based only, but agents can work around these.
Maintenance
Related MCP Connectors
Calories, protein, carbs and fat for restaurant menu items. Search is free; lookups paid via x402.
Ask about your own food diary, nutrient gaps and goals, look up foods, and log meals by chat.
Persistent food journal for AI assistants. Log meals, save recipes, plan meals and track nutrition.
Find restaurants and sourced dietary dish evidence. Free discovery; metered menus need an API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides real-time access to menus from all six MIT Bon Appétit dining halls. It enables users to query daily or weekly schedules and filter options by specific dietary requirements such as vegan, halal, or gluten-free.79 npm1MIT
- AlicenseAqualityDmaintenanceEnables natural language access to USDA's FoodData Central database with 1M+ foods, supporting search, nutrition facts, food comparison, and daily value calculations.8MIT
- FlicenseNot gradedqualityDmaintenanceEnables logging food into MyFitnessPal diary via natural language, supporting search, log, quick add, and diary retrieval.-
- AlicenseNot gradedqualityCmaintenanceEnables querying Yale Hospitality dining menus, listing residential colleges, fetching meal offerings, and searching dishes across colleges via MCP tools.MIT