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.

2. Click + Add New MCP Server.

3. Set Type to SSE or Remote.

4. Set Name to Asian Expats.

5. 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