Metadata-Version: 2.4
Name: eat-what-today-mcp
Version: 0.1.0
Summary: MCP server for deciding what to eat using random takeout favorites
Author-email: qizho27@outlook.com
Requires-Python: >=3.13
Requires-Dist: mcp[cli]>=1.26.0
Description-Content-Type: text/markdown

# Eat What Today MCP

A simple MCP server that helps users decide what to eat by randomly picking from a takeout favorites list.

## Features

- Built-in takeout favorites list
- Random meal recommendation with optional filters
- Random markdown checklist for quick decision making
- MCP resource endpoint for reading the full favorites list

## Tools

- `list_favorites`
	- Returns the full default favorites list.
- `decide_meal`
	- Randomly picks meals from favorites.
	- Args:
		- `count` (default `3`)
		- `price_tier` (`any|low|mid|high`)
		- `spicy` (`any|none|mild|hot`)
		- `category` (default `any`)
		- `seed` (optional integer for deterministic picks)
- `random_takeout_checklist`
	- Returns a markdown todo checklist from random picks.
	- Args:
		- `count` (default `5`)
		- `seed` (optional integer)

## Resource

- `takeout://favorites`
	- Returns the favorites list as markdown.

## Run Locally

From project root:

```bash
uv run eat-what-today-mcp
```

This starts the server with `stdio` transport.

## Example MCP Client Config

```json
{
	"mcpServers": {
		"eat-what-today": {
			"command": "uv",
			"args": [
				"run",
				"eat-what-today-mcp"
			]
		}
	}
}
```
