# Taiwan Garbage Truck Map

> Taiwan Garbage Truck Map is an MCP server for maps and travel. Garbage truck stops and arrival times for six Taiwanese cities and counties. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://garbage.yukai.dev
- **Repository:** https://github.com/yukaii/garbage/tree/HEAD/mcp
- **MCP Registry name:** dev.yukai/taipei-trash
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel), [local services](https://ai-powered.com/categories/local-services)
- **Listing updated:** 2026-11-14

## About

Taiwan's collection routes are published as separate city datasets, and this server puts four read-only lookups over them. It reuses the field mappings of the garbage.yukai.dev web app, so answers match what the site shows.

A call can list the supported cities with their bounding boxes, find stops within 50 to 2,000 metres of a coordinate nearest first, search a city by district, village, road or route keyword, or fetch one stop together with every stop on its route in arrival order. New Taipei, Taichung, Changhua and Yunlin data carries weekly schedules and a flag for whether the truck serves the stop today, computed in Taiwan time. Taipei and Kaohsiung do not publish weekday schedules, so those fields are left out.

Data is fetched from published JSON files and cached in memory for an hour. Taichung's dataset is large, about 50 MB, and the README notes a cold load takes roughly a second. A firewall rule limits traffic to 60 requests a minute per IP.

## Features

- **Nearby stop search:** Finds stops within 50 to 2,000 metres of a coordinate, sorted nearest first.
- **Keyword search:** Searches a city's stops by district, village, road or route.
- **Route schedule lookup:** Returns a stop plus every stop on its route in arrival order.
- **Weekly schedules:** Where cities publish them, stops carry weekday schedules and a serves-today flag.
- **Read-only and rate limited:** All tools are read-only and the endpoint allows 60 requests a minute per IP.

## Good for

- Ask when the garbage truck reaches the stop near your address
- Find the closest collection point to a given coordinate
- Look up a recycling truck route by road name
- Check which weekdays a New Taipei stop is served

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http taipei-trash https://mcp.garbage.yukai.dev/mcp
```

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

```sh
https://mcp.garbage.yukai.dev/mcp
```

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

```json
{
  "mcpServers": {
    "taipei-trash": {
      "url": "https://mcp.garbage.yukai.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "taipei-trash": {
      "type": "http",
      "url": "https://mcp.garbage.yukai.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "taipei-trash": {
      "serverUrl": "https://mcp.garbage.yukai.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.garbage.yukai.dev/mcp
```

Enter a Name (for example "Taiwan Garbage Truck Map"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "taipei-trash": {
      "type": "http",
      "url": "https://mcp.garbage.yukai.dev/mcp"
    }
  }
}
```

## Tools

- `list_cities`: Lists supported cities, their IDs and geographic bounding boxes.
- `find_nearby_points`: Finds stops within 50 to 2,000 metres of a coordinate, nearest first.
- `search_points`: Searches stops in a city by district, village, road or route keyword.
- `get_schedule`: Returns a stop with every stop on its route in arrival order.

## FAQ

### Which cities are covered?

Taipei, New Taipei, Taichung and Kaohsiung through the MCP server, with the website also naming Changhua County and Yunlin County.

### What time zone are times in?

All times are in Asia/Taipei.

### Does it need credentials?

The README describes a public streamable HTTP endpoint and does not mention any key.

### Can I use it from a stdio-only client?

Yes, the README suggests running npx mcp-remote against the endpoint.

### Why are some stops missing weekday data?

Taipei and Kaohsiung do not publish weekday schedules.

### How do I add Taiwan Garbage Truck Map to Claude Code?

Run this command in your terminal: claude mcp add --transport http taipei-trash https://mcp.garbage.yukai.dev/mcp

### What are the best alternatives to Taiwan Garbage Truck Map?

The closest alternatives to Taiwan Garbage Truck Map are City Atlas 城市圖譜, Taiwan Road Safety Data (Unofficial), 生活即時查詢, Road Tag - Accessible Road Reports and Korea Transit (TAGO).

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [City Atlas 城市圖譜](https://ai-powered.com/mcp/city-atlas): City Atlas 城市圖譜 is a free MCP server for maps and travel.
- [Taiwan Road Safety Data (Unofficial)](https://ai-powered.com/mcp/taiwan-road-safety-data-unofficial): Taiwan Road Safety Data (Unofficial) is a free MCP server for maps and travel.
- [生活即時查詢](https://ai-powered.com/mcp/listing-46): 生活即時查詢 is a free MCP server for local services.
- [Road Tag - Accessible Road Reports](https://ai-powered.com/mcp/road-tag-accessible-road-reports): Road Tag - Accessible Road Reports is an open-source MCP server for maps and travel.
- [Korea Transit (TAGO)](https://ai-powered.com/mcp/korea-transit-tago): Korea Transit (TAGO) is an open-source MCP server for maps and travel.
- [Lviv Public Transport](https://ai-powered.com/mcp/lviv-public-transport): Lviv Public Transport is a free MCP server for maps and travel.
- [GTFS Scorecard](https://ai-powered.com/mcp/gtfs-scorecard): GTFS Scorecard is an open-source MCP server for maps and travel.
- [RouteMetrics](https://ai-powered.com/mcp/routemetrics): RouteMetrics is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/taiwan-garbage-truck-map
