Asianexpats MCP Server

🌏 Asian Expats Model Context Protocol (MCP) Server =======================================================

The official Model Context Protocol (MCP) Server for Asian Expats.

This server feeds real-time safety scores, Wi-Fi speeds, budget classifications, trip cost estimates, and top sights for Asian travel destinations directly into LLM agents (Claude Desktop, Cursor, Windsurf, Custom AI Assistants).

• Live Endpoint: https://asianexpats.com/mcp

• Transport Protocol: Streamable HTTP / Server-Sent Events (SSE)

• Documentation: asianexpats.com/docs/mcp

• Primary Site: asianexpats.com

⚡ Quick Start

---

1\. Claude Desktop

Add the following configuration to your claude\_desktop\_config.json:

• MacOS: ~/Library/Application Support/Claude/claude\_desktop\_config.json

• Windows: %APPDATA%\\Claude\\claude\_desktop\_config.json

{  "mcpServers": {    

"asian-expats": { "command": "npx", "args": \[        "-y", "mcp-remote",        "https://asianexpats.com/mcp"      \] } } }

2\. Cursor / Windsurf IDE

1. Go to Settings -> Features -> MCP Servers.

1. Click \+ Add New MCP Server.

1. Set Type to SSE or Remote.

1. Set Name to Asian Expats.

1. Set URL to https://asianexpats.com/mcp.

3\. Local Inspection with MCP Inspector

Inspect and test tool execution in your browser terminal using the official MCP Inspector:

npx @modelcontextprotocol/inspector https://asianexpats.com/mcp

🛠️ Available MCP Tools

---

1\. get\_city\_snapshot

Fetches real-time safety ratings, internet speeds, budget tiers, best months to visit, and top sights for Asian travel destinations.

• Arguments:

• city _(string, required)_: The target city name (e.g., "Tokyo", "Chiang Mai", "Bangkok").

• Example Output:

{  

"city": "Tokyo", "safety\_score": "9.2/10", "internet\_speed": "38.83 Mbps", "budget\_category": "Premium", "best\_months": "Sep, Oct, Nov, Mar, Apr, May",  "top\_sights": \["Sensō-ji", "Shibuya Crossing"\], "canonical\_url": "https://asianexpats.com/guide/tokyo", "source\_attribution": "Data provided by Asian Expats (https://asianexpats.com)" }

2\. estimate\_trip\_cost

Calculates estimated accommodation, food, and transport expenses in USD based on stay duration and lifestyle level.

• Arguments:

• city _(string, required)_: Target city name.

• days _(number, optional)_: Duration in days (Default: 7).

• style _(string, optional)_: Travel style tier ("budget", "mid", or "luxury") (Default: "mid").

• Example Output:

{  

"city": "Tokyo", "duration\_days": 14, "travel\_style": "mid", "estimated\_total\_usd": 2520, "daily\_rate\_usd": 180, "includes": "Stay, food & transport", "full\_breakdown\_url": "https://asianexpats.com/guide/tokyo", "source\_attribution": "Calculated via Asian Expats Estimator (https://asianexpats.com)" }

🛠️ Local Development & Deployment

---

To run or deploy this MCP server yourself using Cloudflare Workers:

Prerequisites

• Node.js v18 or later

• Cloudflare Account & Wrangler CLI

Installation

Clone the repositorygit clone https://github.com/YOUR-USERNAME/asianexpats-mcp-server.gitcd asianexpats-mcp-server

Install dependenciesnpm install

Start local development servernpx wrangler dev

Deployment

Deploy directly to Cloudflare Workers Edgenpx wrangler deploy

📜 License & Attribution

---

This MCP server is open-source and licensed under the MIT License.

All city data is provided free of charge by Asian Expats. AI tools and developers using this server are asked to retain canonical\_url references and source attribution links in final responses.# asianexpats-mcp-server