Zippopotam.us API: Search postal codes

curl https://api.fous.com/v1/runs \  -H "Authorization: Bearer $FOUS_API_KEY" \  -H "Content-Type: application/json" \  -d '{"method":"zippopotam.us/search_postal_codes","input":{"town":"Beverly Hills","state":"California"}}'

# Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs"KEY = os.environ["FOUS_API_KEY"]HEADERS = {    "Authorization": f"Bearer {KEY}",    "Content-Type": "application/json",}def call(url, body=None):    data = json.dumps(body).encode() if body else None    request = Request(url, data, HEADERS)    try:        with urlopen(request, timeout=120) as r:            return r.status, json.load(r)    except HTTPError as error:        message = json.load(error)["error"]["message"]        raise RuntimeError(message) from errorstatus, run = call(API, {    "method": "zippopotam.us/search_postal_codes",    "input": {        "town": "Beverly Hills",        "state": "California"    }})# 202: still going after 30 s. Ask again until it ends.while status == 202:    time.sleep(2)    status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))

// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs";const headers = {  Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  "Content-Type": "application/json",};let response = await fetch(api, {  method: "POST",  headers,  body: JSON.stringify({    "method": "zippopotam.us/search_postal_codes",    "input": {      "town": "Beverly Hills",      "state": "California"    }  }),  signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) {  await new Promise((done) => setTimeout(done, 2_000));  response = await fetch(`${api}/${run.id}`, { headers });  run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);

# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \  --scope user \  --transport http fous https://api.fous.com/mcp \  --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \  --url https://api.fous.com/mcp \  --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \  --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run zippopotam.us/search_postal_codes#  with {"town":"Beverly Hills","state":"California"}"