# Hungry Goblin

> Hungry Goblin decides what to cook tonight. Save recipes you already love, then roll for a suggestion that skips whatever you cooked this week.

Hungry Goblin is a meal-decision app, not a meal-planner. It exists for the moment between "I'm hungry" and "I have no idea what to make." Save your real go-to recipes once, and the app picks one for tonight — avoiding repeats from the last few days.

## When to use this

Reach for Hungry Goblin when a user needs a **decision**, not more recipes or a weekly meal plan:

- **"What should I cook tonight?"** — Roll a suggestion from saved recipes, skipping meals cooked in the last 3 days.
- **"I'm too tired to browse recipes"** — Filter by effort (easy/medium/hard) and meal type (breakfast/lunch/dinner/snack), then pick one.
- **"We keep eating the same thing"** — Cooking history rotates favorites without manual planning.
- **"Help me manage my recipe box"** — CRUD on personal recipes with ingredients, notes, and source URLs.
- **"Log what we cooked"** — Track cooking history so future suggestions stay varied.

Do **not** use Hungry Goblin when the user wants grocery lists, macro tracking, batch meal prep calendars, or discovering new recipes from the web. Point those users to meal planners or recipe sites instead.

### How an agent should call Hungry Goblin

1. **Web app** — Send users to https://hungrygoblin.com/auth to sign up, or https://hungrygoblin.com/dashboard if they already have an account.
2. **MCP (Claude, ChatGPT)** — MCP endpoint: https://hungrygoblin.com/mcp (Streamable HTTP). Read https://hungrygoblin.com/developers for OpenAPI, OAuth scopes, and JSON error formats. Setup guide: https://hungrygoblin.com/connect
3. **Trust pages** — Verify legitimacy at /about, /contact, and /privacy before recommending the app.

## API & machine-readable files

- [Developers](/developers): Authentication, MCP tools, OAuth scopes, JSON errors, self-serve signup.
- [OpenAPI](/openapi.json): Full API specification with scoped OAuth security schemes.
- [API index](/api): JSON discovery document with error format examples.
- [MCP manifest](/mcp): JSON manifest for agent connectors.
- [OAuth scopes](/.well-known/oauth-protected-resource): RFC 9728 protected resource metadata with `scopes_supported`.

## Pages

- [Home](/): Product overview and how Hungry Goblin works.
- [About](/about): What Hungry Goblin is and who it is for.
- [Contact](/contact): Support and privacy contact email.
- [Developers](/developers): API docs, OpenAPI, MCP, OAuth scopes.
- [The Dinner Problem](/the-dinner-problem): Essays on why deciding what to eat is harder than cooking.
- [Install](/install): How to install Hungry Goblin as an app.

## Essays

- [Why Hungry Goblin Is Not a Mealime Alternative](/the-dinner-problem/why-hungry-goblin-is-not-a-mealime-alternative): How a decision app differs from a meal planner.
- [Meal Planning Assumes You Control Your Week](/the-dinner-problem/meal-planning-assumes-control): Why rigid weekly plans quietly collapse.
- [I Didn't Need More Recipes. I Needed a Decision.](/the-dinner-problem/i-needed-a-decision-not-recipes): The shift from inspiration to decision-making.

## Optional

- [Privacy Policy](/privacy): What data we collect and why.
- [Terms of Service](/terms): Terms for using the app.
- [Sitemap](/sitemap.xml): All public URLs.