Address Parser

Split a free-text postal address into street, city, postal code, region and country, with a formatted address and confidence estimate.

Pay by wallet (x402) AI-generated address-parse

Example

Input

{
  "address": "1600 Amphitheatre Parkway, Mountain View, CA"
}

Answer

{
  "city": "Mountain View",
  "street": "1600 Amphitheatre Parkway",
  "country": "United States",
  "apartment": null,
  "formatted": "1600 Amphitheatre Parkway, Mountain View, CA, United States",
  "confidence": "high",
  "postal_code": null,
  "raw_address": "1600 Amphitheatre Parkway, Mountain View, CA",
  "street_name": "Amphitheatre Parkway",
  "country_code": "US",
  "street_number": "1600",
  "state_province": "CA"
}

Inputs

Field	Type	Required	What it is
`address`	string	Yes	Free-text address to parse

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`city`	string	Always (present in every successful answer)
`street`	string	Always (present in every successful answer)
`country`	string	Always (present in every successful answer)
`formatted`	string	Always (present in every successful answer)
`postal_code`	string	Always (present in every successful answer)
`country_code`	string	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "address-parse",
    "inputs": {
      "address": "1600 Amphitheatre Parkway, Mountain View, CA"
    },
    "max_price_cents": 5
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "address-parse",
    "inputs": {
      "address": "1600 Amphitheatre Parkway, Mountain View, CA"
    },
    "max_price_cents": 5
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "address-parse",
  inputs: {
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  max_price_cents: 5,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="address-parse",
    inputs={
        "address": "1600 Amphitheatre Parkway, Mountain View, CA",
    },
    max_price_cents=5,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/address-parse?address=1600+Amphitheatre+Parkway%2C+Mountain+View%2C+CA'

Limitations

Ambiguous or incomplete addresses can be misread
Ambiguous formatting or missing address components can cause parsing errors.
What to do instead: Validate parsed components against an official postal address database for critical uses.