# Seoul Essentials MCP server

> Provides structured data about essential public facilities in Seoul to help AI agents assist foreign tourists with real-time queries.

- Repository: https://github.com/do-droid/seoul-essentials
- Page: https://hostedmcp.org/servers/do-droid/seoul-essentials
- Transport: remote
- Stars: 0
- Latest version: 0.2.0

## Install

### Claude Code

```sh
claude mcp add seoul-essentials -- docker run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0
```

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

```json
{
  "mcpServers": {
    "seoul-essentials": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/do-droid/seoul-essentials:0.2.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "seoul-essentials": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/do-droid/seoul-essentials:0.2.0"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"seoul-essentials","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/do-droid/seoul-essentials:0.2.0"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "seoul-essentials": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/do-droid/seoul-essentials:0.2.0"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add seoul-essentials -- docker run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.seoul-essentials]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/do-droid/seoul-essentials:0.2.0"]
```

### Gemini CLI

```sh
gemini mcp add -s user seoul-essentials docker -- run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "seoul-essentials": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/do-droid/seoul-essentials:0.2.0"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `API_BASE_URL` | no | no |  |

## Tools (11)

- `type`
- `district`
- `filters`
- `limit`
- `lat`
- `lng`
- `radius_m`
- `station`
- `line`
- `day_type`
- `direction`

## FAQ

### What kind of data does Seoul Essentials provide?

It provides data for over 17 types of facilities including WiFi hotspots, AED locations, pharmacies, public restrooms, subway stations, and more.

### Can I find pharmacies that speak English?

Yes, you can use the English filter to narrow results to approximately 400 pharmacies that have surveyed English, Chinese, or Japanese service capabilities.
