English Français العربية

Thailand Data MCP

Registre officiel IA et agents

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package thailand-data-mcp
Claude Code 
claude mcp add thailand-data-mcp -- npx -y thailand-data-mcp@0.1.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "thailand-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "thailand-data-mcp@0.1.2"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. thailand-data-mcp-server
  2. Tools
  3. Install & run
  4. Example
  5. Data sources & licenses
  6. Behavior notes
  7. Development

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

pnpm install
pnpm build
node 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:

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

pnpm dev    # tsx watch

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

Questions fréquentes

Qu'est-ce que Thailand Data MCP ?

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

Comment installer Thailand Data MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add thailand-data-mcp -- npx -y thailand-data-mcp@0.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Thailand Data MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Thailand Data MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Thailand Data MCP ?

Il est publié par narinthon-so. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.