MCP server: One MCP server.

Postio — UK Address, Postcode, Email & Phone Validation

@postioRun by its publisher: served from their own domain, namespace checked by the registry.MCP server · External

Validate UK addresses, postcodes, emails and phone numbers — Royal Mail PAF, live SMTP and HLR.

Maps & geocodingv0.1.4MITTypeScript
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@postio/mcpv0.1.4

Run

npx -y @postio/mcp

MCP client config

{
  "mcpServers": {
    "postio-uk-address-postcode-email-phone-validation": {
      "command": "npx",
      "args": [
        "-y",
        "@postio/mcp"
      ]
    }
  }
}
README2 min read

postio-integrations

Postio is the UK validation API for addresses, emails and phone numbers. This repo holds the JS-family npm packages, the AI / agent surface, and the cdn.postio.co.uk Worker that powers Postio's browser drop-in.

First time? Sign up free — first 100 lookups on us, no card needed.

The Postio API + OpenAPI spec live in postio-uk/postio-api. The spec is also published as @postio/openapi.

Packages

PackageWhat it is
@postio/api-typesTypeScript types generated from the OpenAPI spec.
@postio/coreRuntime-agnostic typed client (browser / Node / Workers / Bun / Deno).
@postio/nodeNode SDK on top of core — retries with exponential backoff, structured logger hook.
@postio/postman-collectionPostman v2.1 collection for every endpoint.
@postio/address-finderBrowser address autocomplete — ARIA combobox, themable, framework-agnostic source.
@postio/address-finder-bundledThe same component prebuilt for <script> tag use.
@postio/reactReact hooks + <AddressFinder /> component, TanStack Query under the hood.
@postio/mcpModel Context Protocol server — npx -y @postio/mcp for Claude Desktop / Cursor / Windsurf / Zed.

Layout

packages/         pnpm workspace; one publishable npm package per subdir
ai/               AI / agent surface (Claude Skill, GPT Action, recommendation prompts)
cdn-worker/       Cloudflare Worker that serves the address-finder bundles
.github/workflows/  CI for publishing + deploying

Building

bash
cd packages
pnpm install
pnpm -r run build

Each package builds independently (pnpm -F @postio/<name> run build). The address-finder bundle has a topological-build quirk — use the ... suffix so its workspace dep builds first:

bash
pnpm -F "@postio/address-finder-bundled..." run build

Contributing

PRs welcome. Conventions:

  • Node 22+, pnpm 10+, ESM only, MIT-licensed.
  • stage is the working branch; master deploys / publishes via CI.
  • One package change per PR where possible.
  • Versions on each package are independent SemVer; bump the version in package.json when you intend a release.

The full integration index — including the server SDKs in their own repos and the WordPress plugin — lives at postio.co.uk/integrations.

License

MIT.

Similar modules

Browse Maps & geocoding