# HeyYumi

> HeyYumi is a free MCP server for maps and travel. Find and book Korean restaurants and salons in any language from an AI chat. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://heyyumi.ai/mcp
- **Repository:** https://github.com/hmp-dev/heyyumi-mcp
- **MCP Registry name:** ai.heyyumi/heyyumi
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

HeyYumi connects assistants to curated data on Korean restaurants, cafes, bars and also hair, nail, lash, waxing and skin-care salons, searched separately from restaurants. An agent can search places or look near a location, read menus and opening hours, show photos uploaded by owners, and send a reservation request, then wait for a confirmation or refusal.

For questions like whether a table for ten is possible right now, a live-status request goes to the venue owner, who answers within five minutes. Sign-in is by Google, with no server URL or API key for ChatGPT's plugin directory; Claude and Perplexity use a custom connector, Cursor and VS Code a one-click install, and Gemini CLI an extension. Personal conversational use is free during the Open Season, while commercial use in company products needs a separate licence.

## Features

- **Place search:** Search by query or nearby location.
- **Reservation requests:** Request and wait for confirmation.
- **Live status:** Ask owners about wait or capacity.
- **Photos:** Show owner-uploaded photos in chat.
- **Salons too:** Hair, nail and similar shops.

## Good for

- Find a restaurant near an address
- Book a table in Korea
- Check if a place can seat a group now
- Request a nail salon appointment

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http heyyumi https://mcp.heyyumi.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.heyyumi.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "heyyumi": {
      "type": "http",
      "url": "https://mcp.heyyumi.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `search_places`: Search places.
- `nearby_places`: Find nearby places.
- `get_place`: Get menus, hours and details.
- `show_place_photos`: Show owner photos.
- `request_reservation`: Send a reservation request.
- `wait_for_reservation`: Wait for confirmation or refusal.
- `get_reservation`: Get a reservation.
- `request_live_status`: Ask the owner a live question.
- `wait_for_live_status`: Wait for a live answer.
- `get_live_status`: Get a live status.
- `resolve_regions`: Resolve regions.
- `list_categories`: List categories.
- `get_stats`: Get statistics.

## FAQ

### Is it free?

Personal chat use is free during Open Season; commercial use needs a licence.

### How do I sign in?

With Google.

### How fast are live answers?

Owners reply within five minutes.

### Which clients?

ChatGPT, Claude, Perplexity, Cursor, VS Code and Gemini CLI.

### Is HeyYumi free?

Yes. HeyYumi is free to use.

### How do I add HeyYumi to Claude Code?

Run this command in your terminal: claude mcp add --transport http heyyumi https://mcp.heyyumi.ai/mcp

### What are the best alternatives to HeyYumi?

The closest alternatives to HeyYumi are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/heyyumi
