China Validators Toolkit
Offline validators for Chinese ID cards, bank cards, plates, USCC and VINs, plus utilities
- Pricing
- Freemium
- Platforms
- API, self-hosted
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 1 day ago
About China Validators Toolkit
China Validators Toolkit is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http agent-tools https://tools.tutlab.tech/mcpAdd to Settings → Connectors → Add custom connector
https://tools.tutlab.tech/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-tools": {
"url": "https://tools.tutlab.tech/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agent-tools": {
"type": "http",
"url": "https://tools.tutlab.tech/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agent-tools": {
"serverUrl": "https://tools.tutlab.tech/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agent-tools": {
"type": "http",
"url": "https://tools.tutlab.tech/mcp"
}
}
}Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Freemium
Free 200 calls/day; pro and mega tiers by daily quota, hosted subscriptions not yet open
Prices change. Check tools.tutlab.tech before you buy.
China Validators Toolkit 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 to China Validators Toolkit

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools