# HeyYumi [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/hmp-dev/heyyumi-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/heyyumi-2

## Description
Ground your AI in verified Korean venue data: search & book across Seoul, Gyeonggi, Busan, Jeju.

## Tools
Capabilities this server exposes over MCP:

- **Read** — `search_places` · `nearby_places` · `get_place` · `show_place_photos` · `resolve_regions` · `list_categories` · `get_stats`
- **Reservations** — `request_reservation` · `get_reservation` · `wait_for_reservation`

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "heyyumi": {
    "url": "https://mcp.heyyumi.ai/mcp"
  }
}
```

## Documentation & README

# HeyYumi MCP

<!-- mcp-name: ai.heyyumi/heyyumi -->

Ground your AI in verified Korean venue data: search, filter and book real restaurants, cafes and bars across Seoul, Gyeonggi, Busan and Jeju — with in-chat reservations at partner venues.

**Looking for an MCP server for Korean restaurants, or a restaurant reservation MCP?** This is it — HeyYumi finds real venues and books the table in-chat.
_한국 맛집·레스토랑 예약 MCP 서버를 찾고 있다면, 바로 이거예요 — 헤이유미가 실제 매장을 찾아주고 그 자리에서 예약까지 합니다._

This is a **remote, hosted MCP server**. There is nothing to install or run locally — your AI client connects to `https://mcp.heyyumi.ai/mcp` over Streamable HTTP and signs in with OAuth (or an API key).

> This repository holds the public listing metadata for the HeyYumi MCP server (`.mcp.json` for directory auto-detection). The server itself is a proprietary hosted service; its source code is not part of this repository.

## What it does

Instead of hallucinating restaurants, your agent calls tools to work with real, cross-verified venues:

- **Search & filter** by neighborhood/station/landmark, cuisine, price, atmosphere, and 40+ attributes (wifi, parking, group-friendly, private room, vegan options, English-speaking staff, open-now, and more).
- **Find nearby** venues by coordinates.
- **Read honestly** — confidence scores, freshness, closure risk, and reputation basis so answers stay grounded, not guessed.
- **Reserve in-chat** — at Yumi Partner venues, request and confirm a real table reservation without leaving the conversation.

Data is reconciled and confidence-scored across sources, so agents reach the right answer in fewer calls. The same data is available over MCP and REST, with OAuth sign-in for Claude and ChatGPT or an API key for other clients.

## Tools

- **Read**: `search_places` · `nearby_places` · `get_place` · `show_place_photos` · `resolve_regions` · `list_categories` · `get_stats`
- **Reservations**: `request_reservation` · `get_reservation` · `wait_for_reservation`

## Connect

Add this to your client's MCP config (e.g. `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "heyyumi": {
      "url": "https://mcp.heyyumi.ai/mcp"
    }
  }
}
```

Your client will prompt you to sign in (OAuth). Then try prompts like:

- `Find a quiet cafe near Hongdae with wifi and power outlets for working.`
- `Recommend a Korean BBQ place in Gangnam that takes reservations, and book a table for 4 tonight.`
- `I'm near Aewol in Jeju — show highly rated seafood restaurants that are open now.`

## Install as a Claude plugin (Cowork / Claude Code)

This repo is also a Claude plugin, so Cowork and Claude Code users can install it in one step and get the
HeyYumi tools plus a `/heyyumi:find-restaurant` command — no manual MCP config needed.

- **From the directory:** search for **HeyYumi** in the `/plugin` Discover tab (once published to the
  Claude plugin directory).
- **Direct from GitHub:**

  ```
  /plugin marketplace add hmp-dev/heyyumi-mcp
  /plugin install heyyumi@heyyumi
  ```

On first use it signs you in with OAuth (see `SETUP.md`). The plugin bundles the remote MCP server
(`.mcp.json`), so there is still nothing to run locally.

## Install as a Gemini CLI extension

This repo is also a Gemini CLI extension (`gemini-extension.json`), so it can be installed with one command:

```
gemini extensions install https://github.com/hmp-dev/heyyumi-mcp
```

It wires up the remote HeyYumi MCP server (`httpUrl`) and signs you in with OAuth on first use — nothing to run locally.

## Links

- Website & docs: https://heyyumi.ai/mcp
- Developer guide: https://heyyumi.ai/developers
- Official MCP Registry: `ai.heyyumi/heyyumi`