# HeyYumi

> HeyYumi is F&B (restaurant & café) grounding data for AI: it anchors answers in real, verified venues so recommendations are sourced, not hallucinated. Each venue is refined into one structured record ("oneset") — normalized hours, menu and price band, parking and amenities, dietary index, atmosphere, accessibility, and 40+ structured attributes — plus confidence and recency scores. Every venue is re-checked on a weekly cycle. Delivered as a REST API and an MCP server so AI agents can read the offline world and answer a user's exact context. Live in Seoul & Jeju now; expanding across Korea and East Asia.

## What it is
- Structured, deduplicated, reconciled venue records — not raw scrapes. Only positive, verified signals are stored (absence means "unknown", never asserted as false).
- The data backbone is public, government-published licensing data; we only verify that each venue is actually operating on existing platforms, then enrich it with owner-verified info and partnered influencer collaborations. The reviews and photos that verification touches are not stored.
- Built for AI grounding (AEO/GEO): machine-readable fields an agent can use directly for search, nearby, detail, and (for partnered venues) reservations.

## Docs
- [API Reference](https://heyyumi.ai/developers): Endpoints, field masks (core/contact_hours/quality/edge/media), attribute filters, and per-call tokens.
- [Playground](https://heyyumi.ai/playground): Try live calls against real data with a demo key.
- [MCP](https://heyyumi.ai/mcp): Model Context Protocol server so agents use HeyYumi mid-reasoning — paste https://mcp.heyyumi.ai and sign in with Google (no API key needed).
- [Pricing](https://heyyumi.ai/pricing): Personal use is free via MCP (~20 questions/day); Plus is ₩4,900/mo. The developer API starts at ₩39,000/mo; contact us for commercial, bulk, or data-license use.

## Product
- [HeyYumi (home)](https://heyyumi.ai): The AI food curator and a live demo of how Yumi answers, grounded in venue data.
- [Story](https://heyyumi.ai/story): Why we build real, verified F&B data — and where it's headed.
- [FAQ](https://heyyumi.ai/faq): How the data is sourced, refreshed weekly, and kept legally clean.

## Contact
- [Contact](https://heyyumi.ai/contact): Partnerships, data licensing, and API access.