get_canteen_dataLABSCO SUMMARY
Useful only if you already have access to the system behind it.
The relative-period argument is the sensible design choice — "last week" resolves server-side, so you never hand the model a date it computed wrongly. But the API base URL and token both come from an administrator, which makes this an internal tool published openly rather than something you can try. Read it as a compact example of wrapping a private endpoint if that is the shape you need.
What it is
A small Python server that fronts an internal canteen-statistics API. One tool answers how many people ate breakfast and lunch over a window, either as explicit dates or as a named relative period, and returns the two counts plus a total as readable text.
What you get
get_canteen_datareturns breakfast, lunch and total headcountsstart_dateandend_dateinYYYYMMDDform for an explicit window- Or a
periodshortcut:today,yesterday,day_before_yesterday,this_week,last_week,this_month,last_month - Results come back as formatted text rather than raw JSON
Requirements
Two environment variables you cannot self-serve: CANTEEN_API_TOKEN and CANTEEN_API_BASE, both obtained from whoever administers the canteen system. Install from PyPI as mcp-server-canteen, version 0.2.8, and run it through uvx from your client config. Without a valid token and base URL the server starts but every call fails.
Setup effort
One command plus a key — pip install mcp-server-canteen, then supply credentials
USE CASES
01
Asking how busy the canteen was last week
Use the relative period rather than working out the dates yourself.
02
Comparing two months
Query this month and last month and let the totals sit side by side.
03
Checking a specific window before an event
Give explicit start and end dates in the expected format and read the breakfast and lunch split.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- pip on PATH
- CANTEEN_API_TOKEN in your environment
- CANTEEN_API_BASE in your environment
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install mcp-server-canteenMCP Clients
Claude Desktop — uvx
CLAUDE DESKTOP — UVX · JSON
{
"mcpServers": {
"canteen": {
"command": "uvx",
"args": [
"mcp-server-canteen"
],
"env": {
"CANTEEN_API_TOKEN": "<YOUR_CANTEEN_API_TOKEN>",
"CANTEEN_API_BASE": "<YOUR_CANTEEN_API_BASE>"
}
}
}
}<YOUR_CANTEEN_API_TOKEN> and <YOUR_CANTEEN_API_BASE> are the API token and the API base URL that your canteen system's administrator issues.
Claude Desktop — uv
CLAUDE DESKTOP — UV · JSON
{
"mcpServers": {
"canteen": {
"command": "uv",
"args": [
"run",
"mcp-server-canteen"
],
"env": {
"CANTEEN_API_TOKEN": "<YOUR_CANTEEN_API_TOKEN>",
"CANTEEN_API_BASE": "<YOUR_CANTEEN_API_BASE>"
}
}
}
}<YOUR_CANTEEN_API_TOKEN> and <YOUR_CANTEEN_API_BASE> are the API token and the API base URL that your canteen system's administrator issues.
Claude Desktop — python
CLAUDE DESKTOP — PYTHON · JSON
{
"mcpServers": {
"canteen": {
"command": "python",
"args": [
"-m",
"mcp_server_canteen.server"
],
"env": {
"CANTEEN_API_TOKEN": "<YOUR_CANTEEN_API_TOKEN>",
"CANTEEN_API_BASE": "<YOUR_CANTEEN_API_BASE>"
}
}
}
}<YOUR_CANTEEN_API_TOKEN> and <YOUR_CANTEEN_API_BASE> are the API token and the API base URL that your canteen system's administrator issues.
