Thai Toolkit MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Thai Toolkit MCP Read ฿1,234.50 in Thai text"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🇹🇭 Thai Toolkit MCP
Thai-specific utilities for AI agents — as a Model Context Protocol (MCP) server.
Give Claude (or any MCP client) the exact, rule-based Thai building blocks it gets wrong on its own: validate a national / tax ID, read an amount as Thai baht text, convert Buddhist-era (พ.ศ.) dates, compute 7% VAT and withholding tax, normalize Thai phone numbers, and look up provinces.
Every tool is a pure, offline function — no API keys, no network calls, deterministic results. Fast, private, and safe to run locally.
Why this exists
LLMs are unreliable at exact Thai tasks: they miscompute the national-ID checksum, misread baht text, and mishandle Buddhist-era years. This server moves those tasks to verified code, so the agent gets the right answer every time.
Related MCP server: thaibulksms
Tools
Tool | What it does | Example ask |
| Validate a 13-digit national / tax ID via checksum | "Is 1-1011-12345-67-8 a valid Thai ID?" |
| Read a THB amount in Thai (for invoices/cheques) | "Write ฿1,234.50 in Thai text" |
| Format / convert Gregorian ↔ Buddhist-era dates | "What is 2026-06-13 in Thai?" |
| Add / extract 7% VAT and withholding tax | "Extract VAT from a ฿1,070 invoice" |
| Normalize to local + E.164, classify mobile/landline | "Format +66 81 234 5678" |
| Province info (Thai/English) and its region | "Which region is Phuket in?" |
Install
git clone https://github.com/wtigero/thai-toolkit-mcp.git
cd thai-toolkit-mcp
pip install -e .Connect it
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"thai-toolkit": {
"command": "thai-mcp"
}
}
}Claude Code:
claude mcp add thai-toolkit -- thai-mcpThen ask: "อ่าน ฿1,234.50 เป็นตัวอักษรไทย" and the agent calls the tool.
Develop
pip install -e ".[dev]"
python -m pytest # or: python tests/test_utils.pyLicense
MIT — see LICENSE.
Available Tools
6 toolsthai_baht_to_textARead-onlyIdempotent
Convert a baht amount to its Thai reading (e.g. 'หนึ่งพันบาทถ้วน').
Useful for invoices, receipts, and cheques.
Returns: JSON string: {"amount", "text"}
Inputs: params (required). Returns: result
thai_calculate_vatARead-onlyIdempotent
Add or extract 7% Thai VAT, and optionally compute withholding tax.
Returns: JSON string with {"base", "vat", "total"} and, if requested, a "withholding" object {"wht_rate_percent", "wht", "net_payment"}.
Inputs: params (required). Returns: result
thai_convert_dateARead-onlyIdempotent
Format an ISO date as a Thai date string, or convert years CE<->BE.
Returns: JSON string. For 'format': {"input", "buddhist_year", "thai_date"}. For year conversion: {"input_year", "result_year", "era"}.
Inputs: params (required). Returns: result
thai_format_phoneARead-onlyIdempotent
Normalize a Thai phone number to local and E.164 forms and classify it.
Returns: JSON string: {"input", "local", "e164", "type", "valid"}
Inputs: params (required). Returns: result
thai_lookup_provinceARead-onlyIdempotent
Look up a Thai province (Thai/English name) and its region.
Returns: JSON string: a single match {"thai", "english", "region_th", "region_en"}, a list of partial matches, or an error message if nothing matches.
Inputs: params (required). Returns: result
thai_validate_idARead-onlyIdempotent
Validate a 13-digit Thai national ID or tax ID using the official checksum.
Returns: JSON string: {"input", "valid": bool, "formatted": str|null}
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct aspect of Thai data (currency, tax, date, phone, province, ID) with no functional overlap. An agent can easily select the appropriate tool without ambiguity.
All tools follow a consistent 'thai_verb_noun' pattern using snake_case, making the API predictable and easy to remember.
Six tools cover a well-scoped set of common Thai-specific utilities without being too few or too many. Each tool serves a clear purpose.
The tool set addresses core Thai localization needs (currency, tax, date, phone, location, ID). Minor gaps exist (e.g., address formatting, income tax) but are acceptable for a focused toolkit.
Maintenance
Related MCP Connectors
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
MCP server for AI dialogue using various LLM models via AceDataCloud
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Related MCP Servers
AlicenseAqualityCmaintenanceA privacy-first MCP server providing 14 offline Brazilian utilities including document validation, boleto parsing, PIX BR Code generation/parsing, and calendar tools.221MIT
thaibulksmsofficial
AlicenseAqualityDmaintenanceMCP server for ThaiBulkSMS and ThaiBulkMail APIs, enabling SMS, email, credit check, and OTP operations through natural language.810 npmMIT- AlicenseAqualityDmaintenanceMCP server exposing Thailand data tools including official company-registry lookups, Thai address normalization, public holidays, and VAT/withholding-tax reference.550 npm1MIT
- AlicenseNot gradedqualityBmaintenanceA remote MCP server that lets any AI agent accept PromptPay QR, credit/debit cards, TrueMoney wallet, internet banking payments in Thailand, and check payment status.MIT