# Send Wheels Router to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "wheels-router",
    "name": "Wheels Router",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/anscg/wheels-router",
    "canonicalUrl": "https://clawhub.ai/anscg/wheels-router",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/wheels-router",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wheels-router",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "wheels-router",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T01:23:12.860Z",
      "expiresAt": "2026-05-18T01:23:12.860Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wheels-router",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wheels-router",
        "contentDisposition": "attachment; filename=\"wheels-router-0.5.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "wheels-router"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/wheels-router"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/wheels-router",
    "downloadUrl": "https://openagent3.xyz/downloads/wheels-router",
    "agentUrl": "https://openagent3.xyz/skills/wheels-router/agent",
    "manifestUrl": "https://openagent3.xyz/skills/wheels-router/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/wheels-router/agent.md"
  }
}
```
## Documentation

### What I do

I help you plan public transit trips anywhere in the world by connecting to the Wheels Router MCP server.

For Hong Kong trips, I use the Wheels Router API which provides:

Detailed routing with MTR, bus, tram, ferry, and walking
Real-time schedules and accurate fares
Platform information and exit details
Interchange discounts (轉乘優惠) when available

For worldwide trips, I use the Transitous API which covers:

Major cities globally with transit data
Basic routing with public transportation
Walking directions and transfers

### When to use me

Use this skill whenever you need to:

Plan a trip using public transportation
Find the best route between two locations
Check transit schedules and connections
Get fare estimates for Hong Kong transit
Search for locations before planning routes

Examples:

"How do I get from Yau Tong MTR to Hong Kong Airport?"
"What's the best way to Central from Causeway Bay right now?"
"Plan a trip from Tokyo Station to Shibuya"
"Search for locations near Victoria Park"

### If you're using mcporter (clawdbot, etc.)

Follow your mcporter skill, if you don't have one follow below:
Add to config/mcporter.json:

{
  "mcpServers": {
    "wheels-router": {
      "description": "Plan public transit trips globally",
      "baseUrl": "https://mcp.justusewheels.com/mcp"
    }
  }
}

Then call tools directly:

npx mcporter call wheels-router.search_location query="Hong Kong Airport"
npx mcporter call wheels-router.plan_trip origin="22.28,114.24" destination="22.31,113.92"

### For other MCP clients

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wheels-router": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.justusewheels.com/mcp"]
    }
  }
}

Cursor/Windsurf/VS Code (.cursor/mcp.json or similar):

{
  "mcpServers": {
    "wheels-router": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.justusewheels.com/mcp"]
    }
  }
}

### search_location

Search for places before planning trips. Always use this first if you don't have exact coordinates.

Parameters:

query (required): Place name or address (e.g., "Hong Kong Airport", "Yau Tong MTR Exit A2")
limit (optional): Number of results (1-10, default 5)

Example:

search_location({
  query: "Hong Kong International Airport",
  limit: 3
})

Returns:

display_name: Full address
lat, lon: Coordinates for use in plan_trip
type, class: Location category

### plan_trip

Plan a transit route between two points.

Parameters:

origin (required): Starting point as "lat,lon" or "stop:ID"
destination (required): Ending point as "lat,lon" or "stop:ID"
depart_at (optional): ISO 8601 departure time (e.g., "2026-01-26T10:00:00+08:00")
arrive_by (optional): ISO 8601 arrival deadline
modes (optional): Comma-separated modes like "mtr,bus,ferry" (only specify if needed)
max_results (optional): Limit number of route options (1-5)

Example:

plan_trip({
  origin: "22.2836,114.2358",
  destination: "22.3080,113.9185",
  depart_at: "2026-01-26T14:30:00+08:00",
  max_results: 3
})

Returns:

plans: Array of route options

duration_seconds: Total trip time
fares_min, fares_max: Fare range in HKD (Hong Kong only)
legs: Step-by-step directions

type: "walk", "transit", "wait", "station_transfer"
Transit legs include: route name, headsign, stops, platform info
Walk legs include: distance, duration

### Best practices

Always search first: Use search_location to find coordinates before calling plan_trip
Use coordinates: Plan trips with lat,lon format for best results
Specify times: Include depart_at or arrive_by for accurate schedules
Check multiple options: Request 2-3 route options with max_results
Understand fares: fares_min and fares_max show the range—interchange discounts are noted separately when available

### Important notes

Interchange discounts (轉乘優惠): Only shown when explicitly present in Hong Kong routes, not all routes qualify
Real-time data: Hong Kong routes use live schedules; worldwide coverage may vary
Time zones: Use UTC or local timezone offsets (HKT is UTC+8)
Coverage: Best for Hong Kong; worldwide coverage varies by city

### Example workflow

// 1. Search for locations
const origins = await search_location({ 
  query: "Yau Tong MTR Station", 
  limit: 1 
});

const destinations = await search_location({ 
  query: "Hong Kong Airport", 
  limit: 1 
});

// 2. Plan the trip
const routes = await plan_trip({
  origin: \`${origins[0].lat},${origins[0].lon}\`,
  destination: \`${destinations[0].lat},${destinations[0].lon}\`,
  depart_at: "2026-01-26T15:00:00+08:00",
  max_results: 2
});

// 3. Present the best options to the user or present specific results but only if user asked specifically. By default just give them something like "[walk] > [3D] > [walk] > [Kwun Tong Line] > [walk]"- unless they ask for specifics.

### Error handling

"Could not find location": Try a more specific search query
"No routes found": Check if coordinates are valid and in a covered area
"Invalid time format": Ensure ISO 8601 format with timezone
Rate limits: Be mindful of API usage, cache results when appropriate

### Coverage areas

✅ Full coverage: Hong Kong (MTR, bus, tram, ferry, detailed fares)
✅ Good coverage: Major global cities with Transitous data
⚠️ Limited coverage: Smaller cities may have incomplete transit data
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: anscg
- Version: 0.5.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T01:23:12.860Z
- Expires at: 2026-05-18T01:23:12.860Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/wheels-router)
- [Send to Agent page](https://openagent3.xyz/skills/wheels-router/agent)
- [JSON manifest](https://openagent3.xyz/skills/wheels-router/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/wheels-router/agent.md)
- [Download page](https://openagent3.xyz/downloads/wheels-router)