Skip to content
MCP server

China Validators Toolkit

Offline validators for Chinese ID cards, bank cards, plates, USCC and VINs, plus utilities

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

Add to Settings → Connectors → Add custom connector

https://tools.tutlab.tech/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-tools": {
      "url": "https://tools.tutlab.tech/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools