Skip to main content
Glama
MorningsideMunch MCP Server

MorningsideMunch MCP Server

README.md
# MorningsideMunch MCP Server

An [MCP](https://modelcontextprotocol.io) server that gives agents live Columbia dining data from the MorningsideMunch API: which halls are open, their hours and full menus with dietary labels and allergens.

It is read-only. Every call goes to the production API (`server-mu-topaz.vercel.app`), so the data matches the app.

## Tools

| Tool | What it does |
| --- | --- |
| `list_halls` | Every location, with open-now status, today's hours, meal periods and how many menu items are posted. Filter by `open_now`. |
| `get_menu` | One hall's menu by meal and station. Takes a hall id or a loose name ("JJs", "ferris"), plus optional `meal`, `date`, `dietary` and `exclude_allergens`. |
| `search_menu` | Searches dishes across all halls by text and/or dietary filters, e.g. halal chicken at dinner, or vegan and dairy-free food at halls that are open now. |
| `get_hours` | Hours, open-now and the next open or close time for one hall or all of them. |
| `get_news_events` | Columbia Dining news and events. |

Dietary filters: `halal`, `kosher`, `vegan`, `vegetarian` (also matches vegan items), `gluten_free`. Dates are `YYYY-MM-DD`, and all times are America/New_York.

## Remote endpoint

The same tools are served over Streamable HTTP at `/mcp` on the Vercel deployment, for cloud clients such as Claude connectors and Claude Duet. It's stateless and read-only.

## Setup

```bash
git clone https://github.com/MorningsideMunch/mcp-server.git
cd mcp-server && npm install && npm run build
```

### Claude Code

```bash
claude mcp add morningsidemunch -- node /absolute/path/to/mcp-server/dist/index.js
```

### Claude Desktop, Cursor and other clients

```json
{
  "mcpServers": {
    "morningsidemunch": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"]
    }
  }
}
```

Set `MORNINGSIDEMUNCH_API_URL` to point at another deployment, such as a preview build.

## Where the data comes from

- **Columbia:** the server pulls `dining.columbia.edu` every two hours and works out status, hours and menus per request from Columbia's own schedule data, so breaks, holidays and event closures are reflected automatically. Locations with no published hours report `openNow: null`.
- **Barnard is not included.** Barnard's menu provider serves plausible but wrong data to anything other than its own app, so the server leaves Barnard out rather than risk returning it.

## License

MIT. See [LICENSE](LICENSE).