Access / Integration: If you want trial or integration access to the Thailand Relocation MCP (or to adapt the pattern for another destination), reach out via the contact form with a brief use case and intended channel (web, chat, internal agent). I can provision limited API / SSE credentials or a scoped prompt + tool set for evaluation.

The Thailand Relocation MCP Server converts a deep, structured knowledge base about moving and settling in Thailand into a uniform surface of AI-callable tools, resources, and prompts. Originally scoped for Dutch expats, it now serves a broader international audience planning long‑, mid‑ or exploratory stays.

🛠️Operational Use Beyond Q&A

This MCP isn’t just a question-answer backend. It actively participates in daily content maintenance, regulatory refresh cycles, assisted drafting of new blog posts & guide updates, and structured change propagation across multiple surfaces (web + chat + internal planning tools).

  • Daily sync jobs pull vetted news, policy & visa rule shifts into staging JSON (human review before publish).
  • Regulation diffs trigger regeneration of affected prompts & resource snapshots (e.g. fee bands, document checklists).
  • Bulk content sweep tools flag stale sections (age heuristics + external signal deltas) for one‑click refresh.
  • Blog & guide drafting: prompt templates invoke domain tools to assemble updated context packs before editorial polish.
  • Consistency layer: one data source → multi-channel output (web pages, Telegram bot, internal planning briefs) with zero manual duplication.

Net effect: authoritative relocation intelligence stays current with hours not weeks of lag, and large-scale edits propagate reliably without copy/paste risk.

Current Deployment

Live usage today powers:

The same MCP surface feeds these channels, enabling consistent structured reasoning (visa routes, budgeting, housing pathways, healthcare navigation) across web and chat surfaces without duplicating logic.

Integrated Real Estate Layer

This server supersedes and folds in the full real estate MCP capability set (search, comparable sizing, closing cost estimation, ownership structure guidance, due diligence checklists). It’s adapted for the Thai condo–first reality of overseas / expat acquisition (foreign quota considerations, financing pathways, risk advisories). Agent-facing tools (matching, quick plan scaffolds) and buyer guidance prompts now run on the same unified relocation data manager—so a budgeting or visa prompt can seamlessly chain into property discovery, and property context can enrich relocation or retirement planning outputs. Houses / land flows remain intentionally minimal; focus is high-quality condo intelligence and compliant ownership pathways.

New Education Domain (Aug 2025)

Added a structured education dataset powering school discovery & planning for relocating families:

  • International & bilingual schools (curriculum, phases, fee bands, strengths)
  • Alternative / homeschooling & online pathways
  • Early childhood models (nursery, Montessori, Reggio, fee ranges)
  • Higher education pathways & bridge programs
  • SEN (Special Educational Needs) support centers & service taxonomy

Tools expose concise, machine-composable slices (list / detail / aggregated summary) and stable resources under thailand://education/*. This lets a family relocation prompt stitch visa timing + budget + area + schooling fit in one chain without token bloat.

What It Does (In One Breath)

Visa routes, budget estimation, area intelligence, rentals vs. purchase planning, healthcare navigation, cultural adaptation, retirement pathways—all exposed as typed MCP tools and stable thailand:// resources the model can chain together for context-rich answers.

Why It’s Useful

  • Replaces sprawling forum scraping + ad‑hoc Googling with canonical, versioned data
  • Tools return structured JSON the model can reason over (not prose blobs)
  • Prompt templates guide multi‑step reasoning: visa strategy, budget scenarios, rental negotiation, holistic relocation plan
  • SSE transport = easy inspection (MCP Inspector, curl) + multi-client access

Surface Snapshot

  • 20+ tools (e.g. estimate_budget, get_visa_route, rental_quick_plan, estimate_closing_costs, get_area_cost_snapshot)
  • 10+ prompt templates (visa strategy, budgeting, housing, healthcare, culture, composite relocation)
  • Stable resources like thailand://visa/types, thailand://areas, thailand://realestate/ownership, new education endpoints (thailand://education/schools, thailand://education/alternative, etc.), plus parameterized templates (thailand://budget/estimate/{city}/{household}/{level})

Tool Catalog (Full List)

All tool identifiers exposed (logic intentionally summarized to avoid giving away proprietary composition patterns). Return types are structured JSON (never plain prose) for downstream prompt-chaining.

  • get_visa_types – Catalog of visa types
  • list_visa_routes – High-level route metadata
  • get_visa_route – Detailed sequence / checkpoints (optional brief mode)
  • get_visa_checklist – Required documents & timing (per type)

Banking & Finance

  • get_banking_accounts – Account archetypes & use cases
  • get_transfer_methods – FX / remittance pathways
  • get_banking_tax_notes – Selected tax / compliance considerations

Budget & Cost of Living

  • estimate_budget – City + household profile estimator (multi-band)
  • compare_cities_multi – Cross‑city cost component comparison
  • get_budget_profiles – Household archetype keys
  • get_city_multipliers – Category cost multipliers (ratio form)

Rentals

  • rental_quick_plan – Compressed acquisition & setup plan
  • compare_rental_structures – Lease / structure pros & risks
  • get_rental_process – Phase breakdown (by property type)
  • get_rental_costs – Upfront + recurring components
  • get_rental_risks – Risk advisories & mitigations

Real Estate Purchase

  • estimate_closing_costs – Transaction cost composition estimator
  • property_buying_quick_plan – Condensed acquisition timeline & due diligence focus points
  • get_ownership_rules – Foreign ownership frameworks
  • get_realestate_structures – Acquisition / holding structures
  • get_due_diligence_checklist – Checklist per property type

Areas & Local Intelligence

  • get_all_areas – Master area index
  • get_area_cost_snapshot – Cost multipliers + lifestyle tags
  • get_area_details – Full descriptor & amenities (parameterized)

Cultural & Language Adaptation

  • get_culture_topics – Etiquette & adaptation domains
  • get_language_phrases – Phrase pack by topic

Healthcare

  • get_healthcare_overview – System structure & access pathways
  • get_hospitals_by_city – Hospital listing + attributes filter

Education

  • list_schools – International & bilingual school catalog (filtered server-side)
  • get_school – Detailed school profile by slug
  • summarize_school_landscape – Aggregated multi-city / area comparison snapshot
  • list_alternative_education – Homeschooling & alternative models overview
  • list_early_childhood_models – Early childhood care / pedagogy models & indicative fees
  • list_higher_ed_pathways – Higher education program pathways
  • list_sen_support_services – SEN support categories & centers

Guides & Knowledge Base

  • list_guides – Structured guide index
  • get_guide – Guide by slug
  • search_knowledge – Cross-domain keyword semantic search

Retirement Planning

  • list_retirement_visas – Retirement pathways overview
  • retirement_plan – Composite retirement scenario snapshot

Relocation Composite / System

  • relocation_checklist – High-level phased task list
  • get_persona_profile – Relocation persona profile (scenario scaffolding)
  • system_summary – Dataset + tool counts / diagnostics
  • refresh_cache – Reload immutable JSON (dev / maintenance)

Prompt Catalog (Template Identifiers)

Prompt templates are pure string generators with structured section scaffolds. They orchestrate multi-tool flows; internal heuristics redacted.

Visa Strategy

  • visa_strategy_overview – Primary vs alternative routes
  • visa_route_comparison – Multi-route risk & requirement matrix

Banking & FX

  • banking_setup_plan – Multi-account onboarding & remittance plan
  • fx_optimization_brief – Transfer & timing guidance

Budget & Financial Planning

  • budget_scenario_analysis – Toggle lifestyle / age / insurance bands
  • multi_city_budget_compare – Ranked differential summary

Rentals & Housing

  • rental_acquisition_plan – Search → negotiation → move‑in framing
  • rental_negotiation_brief – Concession & counter strategy
  • housing_pathways_matrix – Rent vs buy vs hybrid framing

Real Estate Risk & Due Diligence

  • realestate_due_diligence_plan – Sequenced verification list
  • ownership_structure_advisor – Structure suitability scoring

Area & Suitability

  • area_comparison_scorecard – Weighted factor summary
  • area_fit_assessment – Persona suitability narrative

Healthcare Navigation

  • healthcare_navigation_brief – Access, insurance, facility strategy
  • hospital_selection_prompt – Facility comparison criteria

Culture & Language

  • culture_adaptation_sprint – 30‑day focus plan
  • language_phrase_retention_plan – Spaced usage strategy

Retirement & Long-Term

  • retirement_strategy_outline – Visa + cost + healthcare pillars

Holistic Relocation

  • relocation_composite_plan – End‑to‑end phased blueprint

IP Note: Template internals (section scoring formulas, weighting heuristics, conditional inserts) intentionally not published; identifiers provided for transparency and integration clarity.

Prompt Architecture & Design Philosophy

The relocation prompt layer turns raw JSON outputs into structured, reasoning-friendly briefs the model can extend without hallucinating or drifting. Core principles:

1. Pure + Deterministic
Every prompt function is a pure template: no network calls, no time-based randomness. This guarantees reproducible shaping of tool outputs and makes test diffs meaningful.

2. Section Contracts
Each template follows a consistent scaffold (HEADER → CONTEXT SUMMARY → DATA EXTRACTS → ANALYSIS FRAMES → ACTION / NEXT STEPS). Downstream chains can target sections by heading token instead of brittle regex over free text.

3. Data Fusion Not Dumping
Prompts never paste full raw tool payloads; they compose a selective, labeled subset (e.g., top 5 cost drivers, 3 highest‑variance line items, visa gating constraints) reducing token load while keeping semantic anchors.

4. Pre-Normalized Vocabulary
Domain synonyms are collapsed earlier in the data layer (e.g., “condo quota” vs “foreign ownership allocation”) so prompts use a single canonical phrase; improves follow‑up instruction precision.

5. Lightweight Scoring Hints (Redacted Logic)
Score bands (e.g., suitability 0–5, risk low/med/high) are rendered with uniform labels; internal weighting math remains private but the output shape is stable for UI or agent consumption.

6. Chainability & Idempotence
Re‑invoking a prompt with identical arguments yields identical structured sections; subsequent enrichment steps (adding education or real estate context) append new labeled blocks instead of rewriting earlier analysis.

Prompt Categories (Deepened)

CategoryInput FocusOutput ShapeTypical Follow-On Tool Calls
Visa Strategyvisa_type(s), profile flagsRoute matrix + gating factorschecklist fetch, timeline calc
Budget Scenariocity, household, lifestyle levelNormalized monthly band table + sensitivity notesarea snapshot, rental quick plan
Housing / Rentalscity, property_type, budgetAcquisition phases + negotiation leverage listrental_costs, area_cost_snapshot
Real Estate Due Diligenceproperty_type, structureRisk cluster summary + due diligence checklist headerdue_diligence resource, closing_costs estimator
Area Comparisonareas[], persona traitsWeighted scorecard + trade‑off narrativearea_details, budget estimate
Healthcare Navigationcity, insurance postureAccess pathway + facility shortlist criteriahospitals_by_city
Culture / Languagetopic set, timeframe30‑day sprint schedule + phrase focuslanguage_phrases
Education (New)city/area set, curriculum prefsSchool landscape summary + shortlist rationalelist_schools, summarize_school_landscape
Holistic Relocationpersona, time horizonPhased integrated plan (visa→housing→schooling→budget)any sub-domain tool

Example (Simplified) Pattern

Pseudo-structure (abbreviated to avoid leaking internal heuristics):

RELOCATION PLAN (persona: remote family, horizon: 12m)
1. VISA STRATEGY
  - Primary: Non-O (family) → extension path summary
  - Alt: ED route (if schooling pivot) …
2. BUDGET SNAPSHOT (Bangkok, mid, 2 adults + 1 child)
  - Core monthly THB bands: housing X – Y, education …
3. AREA SHORTLIST (filters: intl school proximity, transit)
  - Ranked: AreaA (score 4.4), AreaB (4.1)… key trade-offs
4. HOUSING PATHWAY (rent-first → evaluate purchase at month 9)
5. EDUCATION OPTIONS (curriculum preference: IB)
6. RISK / WATCHLIST (regulatory, timing, quota)
7. NEXT ACTION BLOCK (week 1 tasks)

Validation & Testing Approach

  • Snapshot tests assert stable section ordering / headings
  • Token count guardrails (alert if expansion > threshold)
  • Lint pass ensures no raw JSON blocks exceed allowed line count

Why This Matters

Well-behaved prompts shrink model deliberation overhead, reduce hallucinated entities, and create a reliable substrate for autonomous multi-step agents (e.g., “refine budget then regenerate housing plan if rent > threshold”). The structured, minimal style accelerates adaptation for new domains (education just plugged into Holistic Relocation without touching prior sections).

Future: introduce delta prompts (only emit changes since previous plan revision) to further cut token usage in iterative workflows.

🧭Example Query → Tool / Prompt Flows

User Query: “What’s a realistic monthly budget for a solo remote worker in Bangkok, mid lifestyle, and which areas should I shortlist?”
Flow:
  1. Tool estimate_budget (args: city=Bangkok, household=solo, level=mid, brief=true)
  2. Tool get_area_cost_snapshot (for top candidate areas derived from budget’s housing band logic)
  3. Prompt budget_scenario_analysis merges normalized monthly band + variance notes
  4. Prompt area_comparison_scorecard composes weighted suitability (cost, transit, lifestyle, school distance)
Response Shape: Budget table (core categories + ranges) + ranked area scorecard with trade‑offs + next action list.
User Query: “Outline my path to a long‑term family relocation: visa, schooling, interim rent, eventual condo purchase.”
Flow:
  1. Tool get_visa_route (primary family visa code)
  2. Tool list_schools (filters: curriculum=IB, city=Bangkok)
  3. Tool rental_quick_plan (property_type=condo, budget_thb=specified)
  4. Tool estimate_closing_costs (property_type=condo, property_value_thb)
  5. Prompt relocation_composite_plan stitches visa timeline + schooling window + rent-first housing path + purchase evaluation milestone (month 9) + budgeting deltas
Response Shape: Phased plan (sections: Visa Strategy, Education Window, Rental Acquisition, Purchase Evaluation, Cost Anchors, Risks / Watchlist, Immediate Tasks).
User Query: “Compare Non-O family visa vs ED visa trade‑offs for my situation.”
Flow:
  1. Tool get_visa_route (code=Non-O)
  2. Tool get_visa_route (code=ED)
  3. Prompt visa_route_comparison generates matrix (requirements, renewal friction, cost, risk flags)
Response Shape: Side-by-side matrix + narrative recommendation + decision trigger points.
User Query: “Give me a concise view of international school options near my budget and area preferences.”
Flow:
  1. Tool list_schools (filters: curriculum list + fee band)
  2. Tool summarize_school_landscape (area subset)
  3. Prompt area_comparison_scorecard (optional) to overlay area suitability
  4. Prompt relocation_composite_plan (optional) to integrate into overall plan revision
Response Shape: Curated shortlist (max 5) + curriculum rationale + area alignment notes + next enrollment timing steps.
User Query: “Estimate closing costs for a 5M THB condo and highlight major risk checks.”
Flow:
  1. Tool estimate_closing_costs
  2. Tool get_due_diligence_checklist (property_type=condo)
  3. Prompt realestate_due_diligence_plan merges cost composition + risk clusters + verification sequence
Response Shape: Cost breakdown JSON → summarized table + prioritized due diligence tasks + red flag watchlist.

(All flows omit private weighting heuristics; sequence shows external contract only.)

Design Highlights

  • Single data manager loads immutable JSON once (fast, deterministic)
  • Domains separated by tool/resource/ prompt modules (easy extension)
  • Pure prompts (no I/O) simplify testing & reproducibility
  • Structured calculators (budget, closing costs) embedded—no external calls needed

Example Calls

# Budget snapshot (solo, Bangkok, mid)
curl -X POST http://127.0.0.1:8000/messages/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"estimate_budget","arguments":{"city":"Bangkok","household":"solo","level":"mid","brief":true}}}'
 
# Visa route (tourist TR-60)
curl -X POST http://127.0.0.1:8000/messages/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_visa_route","arguments":{"code":"TR-60","brief":true}}}'

Emerging Pattern

Like the broader MCP approach I outlined in the core post, this server shows how domain-normalized data + semantic tooling + guided prompts transform relocation help from generic advice into adaptive, profile-aware planning.

Road Ahead

Adding housing developer/project catalogs, richer comparative area scoring, and multi‑city scenario planners—without changing the contract surface.

Want to experiment or adapt the pattern for another country? Let’s talk.

Read the MCP Servers Deep Dive → | Contact →