Skip to content
BEAD

Postal Address Formatter

Format mailing addresses to country conventions — US, UK, Japan, Germany, Brazil, and more.

TextReference & Lookup
Mailing label
Jane Doe
1600 Amphitheatre Pkwy
Mountain View, CA 94043
UNITED STATES
Single line (forms, CSV)
Jane Doe, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, UNITED STATES
</>Use this tool programmaticallycurl · JavaScript · MCP

Same tool, callable from any HTTP client or from Claude (via MCP). Anonymous: 100 req/day per IP. Sign up for 1,000 req/day.

curl
curl https://api.b-e-a-d.com/tools/address-formatter/run \
  -H "Content-Type: application/json" \
  -d '{
  "recipient": "Jane Doe",
  "organization": "",
  "line1": "123 Main St",
  "line2": "",
  "city": "New York",
  "region": "",
  "postcode": "a",
  "country": "US"
}'
JavaScript (fetch)
const res = await fetch("https://api.b-e-a-d.com/tools/address-formatter/run", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "recipient": "Jane Doe",
  "organization": "",
  "line1": "123 Main St",
  "line2": "",
  "city": "New York",
  "region": "",
  "postcode": "a",
  "country": "US"
}),
});
const data = await res.json();
console.log(data.result);
MCP (Claude Desktop / Claude Code)
# In Claude Desktop / Claude Code, add to your MCP config:
{
  "mcpServers": {
    "bead": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.b-e-a-d.com"]
    }
  }
}

# Then ask Claude to call:
mcp__bead__bead_address_formatter

Full reference: developer docs · OpenAPI spec

Why country-aware?

Address line order, postal-code placement, and which fields are even required differ wildly. The US wants City, State ZIP; the UK puts the postcode on its own line; Japan starts with the postcode and works down from prefecture to street number.

Input flexibility

Fill the fields you have. Anything blank is silently dropped — no awkward empty lines.

You might also like