Localecheck MCP server

by qinisolabs·io.github.qinisolabs/localecheck·v0.1.1

No reviews yet

Verified locale data for AI agents: dates, phone, currency, tax, holidays, addresses (UK/US)

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

New

0 stars37 downloads/wk

Reviews

Write one

Nobody has reviewed Localecheck yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Localecheck tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

format_currency
Format a money amount the way a reader in a given locale expects (symbol position, decimal/thousands separators). USE THIS whenever you show a price/total to a user or put one in an email, invoice, or report. e.g. 1234.5 GBP en-GB -> '£1,234.50'.
is_holiday
Check whether a date (YYYY-MM-DD) is a public/bank holiday. USE THIS when computing business-day deadlines, delivery SLAs, or 'next working day'. GB defaults to England; pass subdiv 'SCT'/'WLS'/'NIR' or a US state code. Country is GB or US.
next_holiday
Find the next public/bank holiday on or after a date (default today). USE THIS to answer 'when is the next holiday' or find the next working day. Country is GB or US; subdiv narrows to a UK nation or US state.
parse_address
Extract structured {country, postcode, city} from a free-text UK or US address. USE THIS when onboarding a user, running a KYC/fraud check, or storing an address, instead of splitting the string yourself. Returns a confidence flag.
parse_date
Convert a human-written date into ISO 8601 (YYYY-MM-DD). USE THIS whenever you need to interpret a date a person typed — especially ambiguous numeric dates like 03/04/2025, which mean different things in the UK (day-first) vs US (month-first) — before storing, scheduling, or acting on it. Pass locale 'en-GB' or 'en-US'. Returns valid:false for impossible dates.
tax_rate
Look up the correct consumption-tax rate. USE THIS before calculating VAT or sales tax on an invoice or quote — never recall the rate from memory, it is DATE-SENSITIVE. GB returns the UK standard VAT rate that applied on the given date (handles historical/temporary changes). US has no national VAT (returns 0); pass a state code like 'CA' for the state base sales-tax rate. Always pass the invoice d
validate_phone
Validate a phone number and normalise it to E.164 (e.g. +442079460958). USE THIS before saving a phone number, dialling, or sending an SMS, instead of trusting raw input. Pass region 'GB' or 'US'. Returns valid:false if the number is not real for that region.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan19 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 97 days ago8/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Localecheck compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 7; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 37; more than 28% of 12,191 servers with a package

What its tools let an agent do: 7 read

Install Localecheck in Claude Code, Cursor or VS Code

Runs npx -y localecheck on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add localecheck -- npx -y localecheck

Add to Cursor

What the publisher says

From the Localecheck repository's README, as published. We do not edit it. Read it on GitHub

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

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

What it does

parsedate · validatephone · formatcurrency · taxrate (VAT/sales-tax by date) · isholiday / nextholiday · 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

PUBLISH.md — release steps · LOCAL_TEST.md — test before publishing

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 ·

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.

Nothing above is checked by us. What we check is on the safety report.

Localecheck: common questions

Is Localecheck MCP server safe?: Mostly: it is graded B (80/100). Read the Localecheck safety report
How do I install Localecheck?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Localecheck need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Localecheck maintained?: The last commit was 135 days ago (2026-06-22). The latest release is v0.1.1.
How does Localecheck compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.