Postio — UK Address, Postcode, Email & Phone Validation MCP Server

Name: Postio — UK Address, Postcode, Email & Phone Validation MCP Server
Author: uk.co.postio

uk.co.postio/postcode-address-validation

Repository Registry

What is the Postio — UK Address, Postcode, Email & Phone Validation MCP server?

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

How to install Postio — UK Address, Postcode, Email & Phone Validation

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

POSTIO_API_KEY
required
secret
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. Only needed for staging.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "postcode-address-validation": {
      "command": "npx",
      "args": [
        "-y",
        "@postio/mcp"
      ],
      "env": {
        "POSTIO_API_KEY": "<YOUR_POSTIO_API_KEY>",
        "POSTIO_BASE_URL": "<YOUR_POSTIO_BASE_URL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "postcode-address-validation": {
      "command": "npx",
      "args": [
        "-y",
        "@postio/mcp"
      ],
      "env": {
        "POSTIO_API_KEY": "<YOUR_POSTIO_API_KEY>",
        "POSTIO_BASE_URL": "<YOUR_POSTIO_BASE_URL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "postcode-address-validation": {
      "command": "npx",
      "args": [
        "-y",
        "@postio/mcp"
      ],
      "env": {
        "POSTIO_API_KEY": "<YOUR_POSTIO_API_KEY>",
        "POSTIO_BASE_URL": "<YOUR_POSTIO_BASE_URL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "postcode-address-validation": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@postio/mcp"
      ],
      "env": {
        "POSTIO_API_KEY": "<YOUR_POSTIO_API_KEY>",
        "POSTIO_BASE_URL": "<YOUR_POSTIO_BASE_URL>"
      }
    }
  }
}

Claude Code

claude mcp add postcode-address-validation --env POSTIO_API_KEY=<YOUR_POSTIO_API_KEY> --env POSTIO_BASE_URL=<YOUR_POSTIO_BASE_URL> -- npx -y @postio/mcp