Skip to main content
Glama
deenesjakoruzh
postio-uk

Postio

Official
by postio-uk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

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

Package

What it is

@postio/api-types

TypeScript types generated from the OpenAPI spec.

@postio/core

Runtime-agnostic typed client (browser / Node / Workers / Bun / Deno).

@postio/node

Node SDK on top of core — retries with exponential backoff, structured logger hook.

@postio/postman-collection

Postman v2.1 collection for every endpoint.

@postio/address-finder

Browser address autocomplete — ARIA combobox, themable, framework-agnostic source.

@postio/address-finder-bundled

The same component prebuilt for <script> tag use.

@postio/react

React hooks + <AddressFinder /> component, TanStack Query under the hood.

@postio/mcp

Model Context Protocol server — npx -y @postio/mcp for Claude Desktop / Cursor / Windsurf / Zed.

Related MCP server: Acuris MCP Server

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

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:

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • PostalDataPI MCP Server

    PostalDataPI
    A
    license
    A
    quality
    D
    maintenance
    Global postal code lookups, validation, and city search for 240+ countries with timezone, admin region, and elevation metadata. Sub-10ms responses at $0.000028/query with 1,000 free queries on signup.
    4
    1
    MIT
  • Acuris MCP Server by Acuris-GmbH

    Acuris MCP Serverofficial

    Acuris-GmbH
    A
    license
    A
    quality
    F
    maintenance
    Enables address validation, geocoding, postcode lookup, and reverse geocoding in 240+ countries, including UK Royal Mail PAF data, through four tools for MCP-aware clients.
    4
    14 npm
    MIT

  • mailverdict

    mailverdict
    A
    license
    Not graded
    quality
    B
    maintenance
    Keyless email validation: disposable/burner, role-account, and free-provider detection, MX checks, and typo suggestions. Tools: check_email, check_domain.
    MIT
  • Acuris Geo MCP Server by Acuris-GmbH

    Acuris Geo MCP Serverofficial

    Acuris-GmbH
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides address validation and geocoding for 240+ countries, including UK Royal Mail PAF and US/Canada census enrichment. Enables batch validation, forward/reverse geocoding, UK postcode expansion, and automatic refunds for failed lookups.
    MIT