🇹🇭 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

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-mcp

Then ask: "อ่าน ฿1,234.50 เป็นตัวอักษรไทย" and the agent calls the tool.

Develop

pip install -e ".[dev]"
python -m pytest            # or: python tests/test_utils.py

License

MIT — see LICENSE.