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

The official **Model Context Protocol (MCP) Server** for [Asian Expats](https://asianexpats.com).

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](https://asianexpats.com/docs/mcp)
    
*   **Primary Site:** [asianexpats.com](https://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](http://docs.google.com/LICENSE).

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