Postio — UK Address, Postcode, Email & Phone Validation

uk.co.postio

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

Add to Cursor Add to VS Code Run on PlugMCP

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}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

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
API key: POSTIO_API_KEY, POSTIO_BASE_URL
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

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

FAQ

Questions

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.

From the publisher

Documentation

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.

Postio — UK Address, Postcode, Email & Phone Validation

uk.co.postio

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

Communication Telephony

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

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}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

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
API key: POSTIO_API_KEY, POSTIO_BASE_URL
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

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

FAQ

Questions

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.

From the publisher

Documentation

postio-integrations

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.