Back to Browse

Postio Integrations MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2
Moderate5.2Moderate Risk

This is a well-structured monorepo for Postio, a UK validation API client library with TypeScript support and MCP integration. The codebase demonstrates solid security practices with proper API key handling via environment variables, no hardcoded secrets, and appropriate input validation. Minor code quality observations exist but do not create security vulnerabilities. The MCP server appropriately requires API keys and limits its scope to validation operations. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue (1 critical, 0 high severity).

7 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

What You'll Need

Set these up before or after installing:

Postio API key (pk_…). Free key, first 100 lookups on us, no card: https://postio.co.uk/signupRequired

Environment variable: POSTIO_API_KEY

Override the API base URL. Defaults to https://api.postio.co.uk. Only needed for staging.Optional

Environment variable: POSTIO_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "uk-co-postio-postcode-address-validation": {
      "env": {
        "POSTIO_API_KEY": "your-postio-api-key-here",
        "POSTIO_BASE_URL": "your-postio-base-url-here"
      },
      "args": [
        "-y",
        "postio-cdn-worker"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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.

Reviews

No reviews yet

Be the first to review this server!