{
  "markdown": "# thailand-data-mcp-server\n\nMCP server exposing Thailand data tools for AI agents: official company-registry lookups, Thai address normalization, public holidays, and VAT/withholding-tax reference.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `thai_company_lookup` | Official DBD registry profile by 13-digit juristic ID: TH/EN name, type, status, registration date, registered/paid-up capital, business objective, registered address. Live data, cached 24h. |\n| `thai_address_normalize` | Free-text Thai address (TH/EN) → structured province/district/subdistrict/postcode with official codes, confidence level, ambiguity candidates, and street-part extraction. Fully offline. |\n| `thai_list_provinces` | Canonical list of all 77 provinces, bilingual, with codes. |\n| `thai_holidays` | Thai public holidays (2025–2026) with lunar-holiday flags. |\n| `thai_vat_reference` | VAT rate/threshold/filing + common WHT rates and the 50 ทวิ certificate rule. Reference only, not tax advice. |\n\n## Install & run\n\n```bash\npnpm install\npnpm build\nnode dist/index.js            # stdio (default)\nTRANSPORT=http PORT=3000 node dist/index.js   # streamable HTTP at /mcp (binds 127.0.0.1)\n```\n\nClaude Code registration:\n\n```bash\nclaude mcp add thailand-data -- node /path/to/thailand-data-mcp/dist/index.js\n```\n\nNo API keys required.\n\n## Example\n\n```\nthai_company_lookup {\"juristic_id\": \"0107536000315\"}\n→ KASIKORNBANK PUBLIC COMPANY LIMITED | บริษัทมหาชนจำกัด | ยังดำเนินกิจการอยู่ | capital 30,246,820,970 THB | ...\n\nthai_address_normalize {\"address\": \"เลขที่ 5 ซอยสุขุมวิท 39 แขวงคลองตันเหนือ เขตวัฒนา กรุงเทพฯ\"}\n→ province กรุงเทพมหานคร / district วัฒนา / subdistrict คลองตันเหนือ / 10110 | confidence: high | street: \"เลขที่ 5 ซอยสุขุมวิท 39\"\n```\n\n## Data sources & licenses\n\n- **Company registry**: [DBD Open Data](https://opendata.dbd.go.th/) `openapi.dbd.go.th` — used under the **DGA Open Government License**, which requires source attribution; every response therefore carries an `attribution` field. Do not strip it.\n- **Geography**: [thailand-geography-data/thailand-geography-json](https://github.com/thailand-geography-data/thailand-geography-json) (MIT) — bundled in `data/`.\n- **Holidays / VAT**: bundled reference data; verify critical values against official announcements (Royal Gazette, Revenue Department, Bank of Thailand).\n\n## Behavior notes\n\n- DBD lookups are cached in-memory for 24h (registry data changes slowly; also keeps request rates polite toward the WAF-fronted upstream).\n- The DBD API mislabels JSON responses as `text/html`; the client parses bodies regardless.\n- HTTP 403/429 from upstream = WAF/rate-limit → the tool returns a retry-later error, not a fabricated \"not found\".\n- \"Not found\" is only reported on the registry's explicit `1004 No data available` status.\n\n## Development\n\n```bash\npnpm dev    # tsx watch\n```\n\nStack: TypeScript, `@modelcontextprotocol/sdk`, Zod. No runtime dependencies beyond the SDK.\n",
  "bytes": 2938,
  "sha": "f9bed7c5a00d6f497c78f84daa20f93487ba74c00985277ca021d3c7a39b884d",
  "repo_slug": "narinthon-so/thailand-data-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_narinthon_so_thailand_data_mcp_174db166/readme"
}