How do I install Postio — UK Address, Postcode, Email & Phone Validation?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Postio — UK Address, Postcode, Email & Phone Validation need an API key?

The publisher lists these environment variables: POSTIO_API_KEY, POSTIO_BASE_URL.

What transport does Postio — UK Address, Postcode, Email & Phone Validation use?

Postio — UK Address, Postcode, Email & Phone Validation runs locally over stdio.

When was Postio — UK Address, Postcode, Email & Phone Validation last checked?

Last checked 2026-10-28. Validate UK addresses, postcodes, emails and phone numbers — Royal Mail PAF, live SMTP and HLR.

Postio — UK Address, Postcode, Email & Phone MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @postio/[email protected]

Credentials from the publisher

POSTIO_API_KEY — Postio API key (pk_…). Free key, first 100 lookups on us, no card: https://postio.co.uk/signup
POSTIO_BASE_URL — Override the API base URL. Defaults to https://api.postio.co.uk/v1 (include /v1). Only needed for staging.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1POSTIO_API_KEY=<secret> POSTIO_BASE_URL=<value> claude mcp add uk.co.postio-postcode-address-validation -- npx -y @postio/mcp@0.1.5

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "uk.co.postio-postcode-address-validation": {4      "command": "npx",5      "args": [6        "-y",7        "@postio/[email protected]"8      ],9      "env": {10        "POSTIO_API_KEY": "<secret>",11        "POSTIO_BASE_URL": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.5

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Postio — UK Address, Postcode, Email & Phone Validation?

Does Postio — UK Address, Postcode, Email & Phone Validation need an API key?

What transport does Postio — UK Address, Postcode, Email & Phone Validation use?

When was Postio — UK Address, Postcode, Email & Phone Validation last checked?

Documentation

postio-integrations

Packages

Layout

Building

Contributing

License