Thailand Data MCP

io.github.narinthon-soPublished by GitHub account narinthon-sov0.1.2Updated Oct 24, 2026

Thai data for AI agents: DBD company-registry lookup, address normalization, holidays, VAT/WHT.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant look up Thai company-registry profiles, normalize Thai addresses, and check holidays and VAT/WHT reference data.

What you can do
Exposes tools for official DBD juristic-entity lookups by 13-digit ID (Thai/English name, type, status, registration date, capital, business objective, registered address), free-text Thai address normalization into province/district/subdistrict/postcode with official codes and confidence, a canonical bilingual list of all 77 provinces, Thai public holidays for 2025-2026, and VAT/WHT reference values. Company lookups are live data cached in memory for 24 hours; address normalization runs fully offline.
When to use it
Useful when an assistant must work with Thai business or administrative data: verifying a Thai company from its juristic ID, structuring messy Thai addresses, or checking Thai holidays and VAT/withholding-tax reference figures.
Requirements
Runs locally as a stdio process from the npm package thailand-data-mcp; Node.js and a build step (pnpm install, pnpm build) are needed. No API keys or environment variables are declared. Company lookups require network access to the upstream DBD open-data API; address, province, holiday and tax-reference tools use bundled data.
Before you install
Company lookups send the queried juristic ID to the upstream DBD open-data service. Responses carry an attribution field required by the DGA Open Government License and should not be stripped. The VAT/WHT tool is reference only, not tax advice, and holiday and tax values should be verified against official announcements. Upstream 403/429 responses are reported as retry-later errors rather than as not found.

Installation

In SourceWeft

  1. Open Thailand Data MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

thailand-data-mcp-server

MCP server exposing Thailand data tools for AI agents: official company-registry lookups, Thai address normalization, public holidays, and VAT/withholding-tax reference.

Tools

ToolWhat it does
thai_company_lookupOfficial 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.
thai_address_normalizeFree-text Thai address (TH/EN) → structured province/district/subdistrict/postcode with official codes, confidence level, ambiguity candidates, and street-part extraction. Fully offline.
thai_list_provincesCanonical list of all 77 provinces, bilingual, with codes.
thai_holidaysThai public holidays (2025–2026) with lunar-holiday flags.
thai_vat_referenceVAT rate/threshold/filing + common WHT rates and the 50 ทวิ certificate rule. Reference only, not tax advice.

Install & run

bash
pnpm installpnpm buildnode dist/index.js            # stdio (default)TRANSPORT=http PORT=3000 node dist/index.js   # streamable HTTP at /mcp (binds 127.0.0.1)

Claude Code registration:

bash
claude mcp add thailand-data -- node /path/to/thailand-data-mcp/dist/index.js

No API keys required.

Example

thai_company_lookup {"juristic_id": "0107536000315"}→ KASIKORNBANK PUBLIC COMPANY LIMITED | บริษัทมหาชนจำกัด | ยังดำเนินกิจการอยู่ | capital 30,246,820,970 THB | ...
thai_address_normalize {"address": "เลขที่ 5 ซอยสุขุมวิท 39 แขวงคลองตันเหนือ เขตวัฒนา กรุงเทพฯ"}→ province กรุงเทพมหานคร / district วัฒนา / subdistrict คลองตันเหนือ / 10110 | confidence: high | street: "เลขที่ 5 ซอยสุขุมวิท 39"

Data sources & licenses

  • Company registry: DBD Open Data 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.
  • Geography: thailand-geography-data/thailand-geography-json (MIT) — bundled in data/.
  • Holidays / VAT: bundled reference data; verify critical values against official announcements (Royal Gazette, Revenue Department, Bank of Thailand).

Behavior notes

  • DBD lookups are cached in-memory for 24h (registry data changes slowly; also keeps request rates polite toward the WAF-fronted upstream).
  • The DBD API mislabels JSON responses as text/html; the client parses bodies regardless.
  • HTTP 403/429 from upstream = WAF/rate-limit → the tool returns a retry-later error, not a fabricated "not found".
  • "Not found" is only reported on the registry's explicit 1004 No data available status.

Development

bash
pnpm dev    # tsx watch

Stack: TypeScript, @modelcontextprotocol/sdk, Zod. No runtime dependencies beyond the SDK.

Source: README.md at commit b7c0538

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts