# China Validators Toolkit

> China Validators Toolkit is a freemium MCP server for developer tools. Offline validators for Chinese ID cards, bank cards, plates, USCC and VINs, plus utilities. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, self-hosted
- **Website:** https://tools.tutlab.tech
- **MCP Registry name:** tech.tutlab.tools/agent-tools
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

This is an API for agents that checks and parses data formats common in China. It validates 18-digit ID card numbers against GB 11643 and reads out the region, birth date and sex, checks bank card numbers by Luhn and BIN lookup, and tests mainland licence plates under GA36-2018 including new-energy and embassy plates. It also checks 18-character unified social credit codes, 17-character VINs, and phone numbers by carrier prefix.

Smaller helpers cover lunar calendar conversion with zodiac and solar terms, uppercase financial renminbi amounts, masking of sensitive numbers in text, ISBN, IBAN, SWIFT/BIC, email syntax, IP and CIDR parsing, and timestamp conversion with time zones. Rule tables are stated as checked up to October 2026, and the checks are offline computations that do not query external services.

Calls need an x-api-key header. Quotas are 200 calls a day on free, 10,000 on pro and 100,000 on mega, with 429 when exceeded. The hosted instance is not yet open for subscription; you can self-deploy and create keys with the bundled CLI.

## Features

- **ID and company codes:** Validates ID card numbers and unified social credit codes and decodes them.
- **Vehicle checks:** Validates licence plates and VINs.
- **Banking formats:** Checks bank cards, IBAN and SWIFT/BIC codes.
- **Sensitive data masking:** Masks ID, phone and card numbers in free text.
- **Lunar calendar:** Converts dates to lunar, stem-branch and solar terms.
- **Developer utilities:** Parses IPs and CIDR, converts timestamps and validates ISBN.

## Good for

- Validate a customer's ID or company code in a form
- Mask personal numbers before logging text
- Identify a carrier from a phone number
- Convert an amount to uppercase renminbi for invoices
- Check a VIN before importing vehicle data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agent-tools https://tools.tutlab.tech/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tools.tutlab.tech/mcp
```

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

```json
{
  "mcpServers": {
    "agent-tools": {
      "url": "https://tools.tutlab.tech/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-tools": {
      "type": "http",
      "url": "https://tools.tutlab.tech/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-tools": {
      "serverUrl": "https://tools.tutlab.tech/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-tools": {
      "type": "http",
      "url": "https://tools.tutlab.tech/mcp"
    }
  }
}
```

## Tools

- `bankcard_validate`: Validates a mainland bank card number and identifies the issuer
- `email_validate`: Checks email address syntax
- `iban_validate`: Validates an IBAN
- `idcard_region`: Resolves a region code to province, city and district
- `idcard_validate`: Validates an 18-digit ID card number and parses it
- `ip_parse`: Parses an IP address or CIDR range
- `isbn_validate`: Validates ISBN-10 and ISBN-13
- `lunar_calendar`: Converts a date to the lunar calendar
- `phone_lookup`: Identifies the carrier of an 11-digit phone number
- `mask`: Masks ID, phone and card numbers in text
- `plate_validate`: Validates a mainland licence plate
- `rmb_upper`: Converts an amount to uppercase Chinese numerals
- `swift_validate`: Validates a SWIFT or BIC code
- `timestamp`: Converts between Unix time and ISO 8601
- `uscc_validate`: Validates a unified social credit code
- `vin_validate`: Validates a VIN and parses its parts

## FAQ

### What are the quotas?

Free is 200 calls a day, pro 10,000 and mega 100,000; extra calls return 429.

### Do the checks call external services?

The page describes them as offline rule checks, for example the email check does no DNS lookup.

### Can I use a hosted instance?

Not yet. The hosted listing is in preparation, so you self-deploy and create keys with the CLI.

### How are calls authenticated?

With an API key in the x-api-key header.

### Is China Validators Toolkit free?

China Validators Toolkit has a free plan, with paid plans for more usage or features.

### How do I add China Validators Toolkit to Claude Code?

Run this command in your terminal: claude mcp add --transport http agent-tools https://tools.tutlab.tech/mcp

### What are the best alternatives to China Validators Toolkit?

The closest alternatives to China Validators Toolkit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/china-validators-toolkit
