Clients: npm, pip, and MCP

1. Get a free API key

Email-only signup. Free tier: 2,000 calls/month, no card. Paid plans from £19/month — pricing.

Get my free key

2. First parse (no SDK required)

curl -s https://api.parseaddr.com/v1/parse \
  -H "Authorization: Bearer $PARSEADDR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"flat 2, 10 downing st, london sw1a 2aa"}'

Docs: /docs · OpenAPI: /openapi.json · Messy-input guide: /parse-messy-addresses-api.

3. Node (npm)

npm install parseaddr
# Until the package is on the public registry, install from the open repo:
# npm install ./packages/npm   (after cloning wezpyke/parseaddr-mcp)

import { parse } from "parseaddr";

const result = await parse(
  "flat 2, 10 downing st, london sw1a 2aa",
  { apiKey: process.env.PARSEADDR_API_KEY }
);
// structured fields: house_number, road, unit, city, postcode, …

Get a free key for npm →

4. Python (pip)

pip install parseaddr
# Until PyPI publish lands:
# pip install ./packages/pypi   (after cloning wezpyke/parseaddr-mcp)

from parseaddr import parse
import os

result = parse(
    "flat 2, 10 downing st, london sw1a 2aa",
    api_key=os.environ["PARSEADDR_API_KEY"],
)

Get a free key for pip →

5. MCP (coding agents)

stdio server parseaddr-mcp — tools parse_address and expand_address. Registry name com.parseaddr/address-parse. Set PARSEADDR_API_KEY; the server calls https://api.parseaddr.com for you.

# from a clone of wezpyke/parseaddr-mcp
npm install ./packages/npm
PARSEADDR_API_KEY=pa_live_… npx parseaddr-mcp

Example MCP client config fragment:

{
  "mcpServers": {
    "parseaddr": {
      "command": "npx",
      "args": ["parseaddr-mcp"],
      "env": { "PARSEADDR_API_KEY": "pa_live_…" }
    }
  }
}

Point command/args at your local install path until the package is on the public npm registry. Source of truth: github.com/wezpyke/parseaddr-mcp.

Get a free key for MCP →

Channel cheat-sheet

What this is not

• Not a self-hosted libpostal binary — the model stays hosted.
• Not USPS / Royal Mail PAF validation — parsing only (validation vs parsing).
• Not an email parser (beyond email.utils.parseaddr()).

parseaddr · home · pricing · docs · GitHub clients