uk.co.postio由 postio.co.uk 发布v0.1.5更新于 Oct 30, 2026
Validate UK addresses, postcodes, emails and phone numbers — Royal Mail PAF, live SMTP and HLR.
通过 Postio API 校验英国地址、邮编、邮箱和电话号码，使用 Royal Mail PAF 数据、实时 SMTP 与 HLR 查询。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
Model Context Protocol server for Postio — the UK validation API for addresses, emails and phone numbers, exposed as tools for any MCP-aware AI host.
First time? Sign up free — first 100 lookups on us, no card needed.
Works with Claude Desktop, Claude Code, Cursor, Windsurf, Zed, Continue, and anything else that speaks MCP over stdio.
Node 20+.
You don't, really. Use npx from your host's MCP config.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
~/.cursor/mcp.json (or <project>/.cursor/mcp.json for project-scoped):
Same JSON as Cursor — they all consume the standard MCP server config shape.
The tools are intentionally primitive and 1:1 with the API. The
agent decides when to chain them — a typical address-finder flow
is postio_address_search → pick a UDPRN → postio_udprn_lookup
for the full record.
Each tool returns the raw API envelope as JSON text, including
meta.requestId for support correlation.
"Look up the address with udprn 25742215." →
postio_udprn_lookupwithudprn=25742215
"Find addresses on Wimpole Street W1G." →
postio_address_searchwithquery="Wimpole Street W1G"
"Is [email protected] a real email address?" →
postio_email_validatewithemail="[email protected]"→ the response includesdidYouMean: "gmail.com".
"Verify these UK phone numbers and tell me which are mobile." →
postio_phone_validateper number.
A missing POSTIO_API_KEY is not fatal — the server still starts and
advertises its tools, so a host can list them before you've configured
credentials. Individual calls then fail with a message telling you to
set the key.
Listed at registry.modelcontextprotocol.io
as uk.co.postio/postcode-address-validation, published under a
domain-verified namespace (not a personal GitHub one).
The listing is generated from server.json in this
directory; the version there tracks this package's version. CI
(publish-mcp-registry.yml) republishes on change.
MIT.
来源：packages/mcp/README.md，提交 9df8477
Search UK addresses by free-form text — building, street, postcode, organisation, or any combination. Returns a list of suggestions, each with a UDPRN (Royal Mail's per-address ID). Pass a chosen UDPRN to `postio_udprn_lookup` to fetch the full record. Free / non-billable.
query必填max_resultsReturn every PAF delivery point at a UK postcode, ordered by building number. Whitespace and case are normalised. Billable on a hit; valid postcodes with no delivery points return an empty list and are not charged.
postcode必填max_resultsLook up a single UK delivery point by its UDPRN (Royal Mail's stable per-address ID). Use this after `postio_address_search` to fetch the full record for a chosen suggestion. Billable on a hit; misses (404) are not charged.
udprn必填Validate an email address: syntax (RFC 5322), typo correction (gnail→gmail), classification (disposable, role, free provider), MX lookup, and live SMTP mailbox probe. Returns an aggregated `deliverability` verdict (deliverable / undeliverable / risky / unknown / invalid) plus every signal independently.
email必填Parse a phone number with libphonenumber and run a live HLR (Home Location Register) lookup. Returns current carrier (post-porting), original carrier, ported flag, reachability, MCC/MNC. Pass numbers in E.164 (`+447700900123`) for unambiguous results.
number必填Free key/health probe. Returns 200 if the API key is active and the upstream search service is reachable. Useful as a smoke test or to warm the worker.
无需输入参数。
已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
claude mcp add postio --env POSTIO_API_KEY=pk_… -- npx -y @postio/mcp{ "mcpServers": { "postio": { "command": "npx", "args": ["-y", "@postio/mcp"], "env": { "POSTIO_API_KEY": "pk_…" } } }}{ "mcpServers": { "postio": { "command": "npx", "args": ["-y", "@postio/mcp"], "env": { "POSTIO_API_KEY": "pk_…" } } }}curl "https://registry.modelcontextprotocol.io/v0.1/servers/uk.co.postio%2Fpostcode-address-validation/versions/latest"