Postio — UK Address, Postcode, Email & Phone Validation

@postio/mcp

Postio の Model Context Protocol サーバーです。住所、メールアドレス、電話番号を検証する英国の API を、MCP 対応のあらゆる AI ホストで使えるツールとして提供します。

初めての方へ： 無料で登録できます。最初の 100 回の検索は無料で、カード情報も不要です。

Claude Desktop、Claude Code、Cursor、Windsurf、Zed、Continue など、stdio 経由で MCP に対応するあらゆる環境で動作します。

Node 20 以上。

インストール

特に必要ありません。ホストの MCP 設定から npx を使用します。

Claude Code

claude mcp add postio --env POSTIO_API_KEY=pk_… -- npx -y @postio/mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "postio": {
      "command": "npx",
      "args": ["-y", "@postio/mcp"],
      "env": { "POSTIO_API_KEY": "pk_…" }
    }
  }
}

Cursor

~/.cursor/mcp.json（プロジェクト単位で設定する場合は <project>/.cursor/mcp.json）：

{
  "mcpServers": {
    "postio": {
      "command": "npx",
      "args": ["-y", "@postio/mcp"],
      "env": { "POSTIO_API_KEY": "pk_…" }
    }
  }
}

Windsurf / Zed / Continue

Cursor と同じ JSON を使用します。いずれも標準的な MCP サーバー設定形式に対応しています。

ツール

ツール	機能	課金対象
postio_address_search	自由形式の英国住所検索 → 候補と UDPRN	いいえ
postio_postcode_lookup	郵便番号に該当するすべての PAF 配達先	該当ありの場合は課金
postio_udprn_lookup	単一の UDPRN の完全なレコード	該当ありの場合は課金
postio_email_validate	構文、入力ミス、MX、SMTP、分類の検証	はい
postio_phone_validate	解析とリアルタイム HLR 照会（通信事業者、番号移転、到達可能性）	はい
postio_connect	無料のヘルスチェック	いいえ

ツールは意図的に基本的な機能に絞り、API と 1 対 1 で対応しています。どのツールを連携するかはエージェントが判断します。一般的な住所検索の流れは、postio_address_search → UDPRN の選択 → 完全なレコードを取得するための postio_udprn_lookup です。

各ツールは、サポート時の照合に使える meta.requestId を含む、生の API エンベロープを JSON テキストで返します。

プロンプトの例

「udprn 25742215 の住所を調べてください。」 → udprn=25742215 を指定して postio_udprn_lookup

「Wimpole Street W1G の住所を検索してください。」 → query="Wimpole Street W1G" を指定して postio_address_search

「[email protected] は実在するメールアドレスですか？」 → email="[email protected]" を指定して postio_email_validate → 応答には didYouMean: "gmail.com" が含まれます。

「次の英国の電話番号を検証し、どれが携帯電話か教えてください。」 → 電話番号ごとに postio_phone_validate を実行します。

設定

環境変数	用途
POSTIO_API_KEY	必須です。 Postio API キーです。
POSTIO_BASE_URL	API のベース URL を任意で上書きします（デフォルトは https://api.postio.co.uk/v1）。

POSTIO_API_KEY が設定されていなくても、サーバーは起動してツールを公開するため、ホストは認証情報の設定前にツールを一覧表示できます。ただし、個々の呼び出しはキーの設定を促すメッセージとともに失敗します。

公式 MCP レジストリ

registry.modelcontextprotocol.io に uk.co.postio/postcode-address-validation として登録されています。個人の GitHub アカウントではなく、ドメイン検証済みの名前空間で公開されています。

curl "https://registry.modelcontextprotocol.io/v0.1/servers/uk.co.postio%2Fpostcode-address-validation/versions/latest"

登録情報は、このディレクトリにある server.json から生成されます。そこに記載されたバージョンは、このパッケージのバージョンに合わせて更新されます。CI（publish-mcp-registry.yml）は変更時に再公開します。

ライセンス

MIT。