mcpField
L
Localecheck

Localecheck

Local
github.com/qinisolabsDeveloper Tools0Updated 19w ago
Repository

About Localecheck

Localecheck provides verified locale utilities for AI agents and developers working with UK and US data. It handles dates, phone numbers, currency, tax rates by date, holidays, and addresses, flagging invalid inputs rather than guessing.

Key features

  1. 01Parse locale-sensitive dates
  2. 02Validate phone numbers
  3. 03Format currencies
  4. 04Look up VAT and sales tax by date
  5. 05Check public holidays
  6. 06Parse UK and US addresses

Use cases

  1. 01Determine historical VAT for an invoice
  2. 02Format amounts for a locale
  3. 03Check holidays when planning delivery dates
  4. 04Validate phone numbers and parse addresses

MCP support

The TypeScript and Python packages provide MCP servers exposing locale parsing, validation, formatting, tax, holiday, and address tools.

#mcp#locale#i18n#vat#tax#currency#dates#phone#holidays#address#validation#finance#agents#typescript

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "localecheck": {
      "command": "npx",
      "args": [
        "-y",
        "localecheck"
      ]
    }
  }
}
Run commandnpx -y localecheck

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmlocalecheck0.1.1

Tools

7

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
inputstringYes
localestringNo

Details

From the project README

localecheck

Locale-correctness tools for AI agents. Agents are systematically wrong about everyday non-US data — they read 03/04 as March 4 in the UK, apply today's VAT rate to a historical invoice, format €1,234.50 for a German reader, and miss bank holidays in delivery dates. localecheck gives them verified answers and flags impossible inputs instead of guessing.

Coverage: UK + USA (v1), expanding. Free, no API key.

Packages

PackageInstallUse
TypeScript (primary)packages/localecheck-tsnpx -y localecheck (live on npm)MCP server and importable library
Pythonpackages/localecheck-pythonfrom source (PyPI release coming soon)MCP server, importable library, REST API

Both wrap the same authoritative libraries (libphonenumber, CLDR/Intl, date-holidays) and share the same hand-curated tax data.

What it does

parse_date · validate_phone · format_currency · tax_rate (VAT/sales-tax by date) · is_holiday / next_holiday · parse_address

Quick start (in an AI app)

{ "mcpServers": { "localecheck": { "command": "npx", "args": ["-y", "localecheck"] } } }

Then ask naturally — the agent picks the tool: "A UK invoice dated 1 June 2009 — what VAT rate?" → 15%.

Repo map

  • packages/localecheck-ts — primary TypeScript package (MCP + library)
  • packages/localecheck-python — Python package + FastAPI REST API
  • eval/ — benchmark harness: how often raw LLMs get this wrong
  • benchmark.html — shareable results page · BUSINESS_MODEL.md — strategy · PUBLISH.md — release steps · LOCAL_TEST.md — test before publishing

Status & caveats

UK VAT history is reliable for the modern era (standard rate). US state sales-tax values are 2025 state base rates (local taxes add on top) — verify against an authoritative feed before live invoicing. Addresses parse + extract a valid postcode/ZIP but don't verify deliverability.

Code: Apache-2.0. Curated tax data: see BUSINESS_MODEL.md.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.