@hatang/mcp

The Ha Tang MCP server. It lets Claude Code, Cursor, VS Code, Windsurf and any other Model Context Protocol client read the Ha Tang developer docs and call the API: send email, create VietQR payments, read e-invoices, work the support inbox and teach the AI assistant.

Install

Claude Code:

claude mcp add hatang --env HATANG_API_KEY=ht_... -- npx -y @hatang/mcp

Cursor (.cursor/mcp.json), Windsurf and other clients that take a JSON config:

{
  "mcpServers": {
    "hatang": {
      "command": "npx",
      "args": ["-y", "@hatang/mcp"],
      "env": { "HATANG_API_KEY": "ht_...", "HATANG_ENVIRONMENT": "development" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "hatang": { "command": "npx", "args": ["-y", "@hatang/mcp"], "env": { "HATANG_API_KEY": "${input:hatang-key}" } }
  },
  "inputs": [{ "id": "hatang-key", "type": "promptString", "description": "Ha Tang API key", "password": true }]
}

The docs tools work without a key. Create a key in the dashboard under Settings → API Keys, with only the scopes the agent needs.

Variable
HATANG_API_KEY	API key (ht_...)
HATANG_ENVIRONMENT	Payments environment: development (no money moves, transfers can be simulated) or production
HATANG_BASE_URL	Default https://api.hatang.dev

Add --read-only to the args to register only the tools that read.

Tools

Tool	What it does
search_docs, read_doc	Search the developer docs and read a page as Markdown (no key needed)
send_email, get_email, list_emails, list_templates	Transactional email
list_domains, get_domain, create_domain, verify_domain	Sending domains and their DNS records
create_payment, get_payment, list_payments, simulate_transfer	VietQR bank-transfer payments
list_einvoices, get_einvoice	E-invoices (hóa đơn điện tử)
list_conversations, get_conversation, send_message, list_customers	The support inbox: website, apps, Zalo, Messenger, email…
knowledge_search, knowledge_upsert	What the AI assistant answers customers from

Tools that send, create or change something are marked as such, so your client asks before running them.

Docs

hatang.dev/docs/guides/sdks/mcp · for code, use the Node.js SDK and the other SDKs.

About Ha Tang

Ha Tang (Hạ Tầng) is a customer support platform for businesses in Vietnam: one inbox for your website, mobile app, Zalo, Messenger, Instagram, TikTok Shop, WhatsApp and email, with an AI assistant, plus a transactional email API, VietQR payments and e-invoices.

• Product: hatang.dev
• Guide: Ha Tang MCP server (Tiếng Việt)
• REST API: hatang.dev/docs/reference/api
• AI coding agents: MCP server and rules
• Changelog: hatang.dev/docs/changelog
• Support: hatang.dev/contact