# Ha Tang

> Ha Tang is an MCP server for developer tools. Docs, email, VietQR payments and support inbox for Ha Tang, in your coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://hatang.dev/docs/guides/sdks/mcp
- **MCP Registry name:** dev.hatang/mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [finance and payments](https://ai-powered.com/categories/finance-and-payments), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-15

## About

A local stdio server on Node 20+ that gives a coding agent both reading and writing access to Ha Tang, a Vietnamese developer platform. Without an API key only the docs tools work, so an agent can read current documentation while it writes an integration.

With a key created under Settings, API Keys, it can send email, add and verify sending domains, create VietQR bank-transfer payments, list e-invoices, work the support inbox and write knowledge for the AI assistant. Payments default to a development environment where no money moves, and simulate_transfer fires IPN and webhooks as if the payer had paid.

A --read-only flag registers only the reading tools. Write tools carry MCP annotations so clients ask before running them. The server talks only to api.hatang.dev and hatang.dev docs.

## Features

- **Docs search:** search_docs and read_doc cover the docs in English or Vietnamese.
- **Email sending:** Send with html, text or templates, and check domain DNS records.
- **VietQR payments:** Create payments and simulate a transfer in development.
- **E-invoices:** List and fetch e-invoices.
- **Support inbox:** Read conversations, reply, add private notes, list customers.
- **Read-only mode:** A flag limits the server to tools that read.

## Good for

- Add order confirmation emails to an app
- Test a VietQR payment flow with a simulated transfer
- Check which DNS records a sending domain lacks
- Summarise unanswered support conversations
- Load an FAQ file into the assistant's knowledge

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env HATANG_API_KEY='<HATANG_API_KEY>' -- npx -y @hatang/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hatang/mcp"
      ],
      "env": {
        "HATANG_API_KEY": "<HATANG_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hatang/mcp"
      ],
      "env": {
        "HATANG_API_KEY": "<HATANG_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hatang/mcp"
      ],
      "env": {
        "HATANG_API_KEY": "<HATANG_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hatang/mcp"
      ],
      "env": {
        "HATANG_API_KEY": "<HATANG_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hatang/mcp"
      ],
      "env": {
        "HATANG_API_KEY": "<HATANG_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_docs`: Searches the docs in English or Vietnamese.
- `read_doc`: Reads one docs page as Markdown.
- `send_email`: Sends an email with html, text or a template.
- `get_email`: Gets a sent email and its status.
- `list_emails`: Lists sent emails.
- `list_templates`: Lists email templates.
- `list_domains`: Lists sending domains.
- `get_domain`: Gets a domain and its DNS records.
- `create_domain`: Adds a sending domain.
- `verify_domain`: Checks a domain's DNS records.
- `create_payment`: Creates a VietQR bank-transfer payment.
- `get_payment`: Gets a payment and its status.
- `list_payments`: Lists payments.
- `simulate_transfer`: Development only: simulates the payer's transfer arriving.
- `list_einvoices`: Lists e-invoices.
- `get_einvoice`: Gets one e-invoice.
- `list_conversations`: Lists support inbox conversations.
- `get_conversation`: Gets a conversation with latest messages.
- `send_message`: Replies in a conversation or adds a private note.
- `list_customers`: Searches customers by name, email or phone.
- `knowledge_search`: Searches the assistant's knowledge.
- `knowledge_upsert`: Creates or replaces a knowledge document.

## FAQ

### Do I need an API key?

Only for the API tools; search_docs and read_doc work without one.

### Can it move real money?

Only if HATANG_ENVIRONMENT is production; keep it on development while building.

### How do I install it in Claude Code?

Run claude mcp add hatang with the env vars, then npx -y @hatang/mcp.

### Can I stop it changing data?

Yes, start it with --read-only.

### How do I add Ha Tang to Claude Code?

Run this command in your terminal: claude mcp add mcp --env HATANG_API_KEY='<HATANG_API_KEY>' -- npx -y @hatang/mcp

### What are the best alternatives to Ha Tang?

The closest alternatives to Ha Tang are Monapay MCP, Vaartix, Dead Simple Email, Hypamoon and Telegram Tools.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Monapay MCP](https://ai-powered.com/mcp/monapay-mcp): Monapay MCP is a freemium MCP server for finance and payments.
- [Vaartix](https://ai-powered.com/mcp/vaartix): Vaartix is an MCP server for communication.
- [Dead Simple Email](https://ai-powered.com/mcp/dead-simple-email): Dead Simple Email is a freemium MCP server for communication.
- [Hypamoon](https://ai-powered.com/mcp/hypamoon): Hypamoon is a freemium MCP server for developer tools.
- [Telegram Tools](https://ai-powered.com/mcp/telegram-tools): Telegram Tools is an open-source MCP server for communication.
- [SendForAI](https://ai-powered.com/mcp/sendforai): SendForAI is a freemium MCP server for communication.
- [Sulato Business Tools](https://ai-powered.com/mcp/sulato-business-tools): Sulato Business Tools is a free MCP server for finance and payments.
- [agentic sinkhole research](https://ai-powered.com/mcp/agentic-sinkhole-research): agentic sinkhole research is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ha-tang
