`census_geocode_batch`

Pack: census-geocoder · Endpoint: https://gateway.pipeworx.io/census-geocoder/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/census_geocode_batch for the schema, then POST the same URL with its arguments for the data.

Geocode up to ${BATCH_MAX} US addresses in a single call and return each one’s match status, standardized address, coordinates, and state/county/tract/block FIPS codes. Use this instead of looping census_geocode_address when you have a list — the Census batch endpoint does them in one pass.

Parameters

Name	Type	Required	Description
`addresses`	array	yes	List of addresses (max ${BATCH_MAX}). Each item is either a one-line string, or an object with street/city/state/zip and an optional id.
`items`	string	no	Your own identifier, echoed back on the result row
`properties`	string	no	Your own identifier, echoed back on the result row
`id`	string	no	Your own identifier, echoed back on the result row
`street`	string	no
`city`	string	no
`state`	string	no
`zip`	string	no
`benchmark`	string	no	Census benchmark, default Public_AR_Current
`vintage`	string	no	Geography vintage, default Current_Current

Example call

Arguments

{
  "addresses": [
    {
      "id": "wh",
      "street": "1600 Pennsylvania Ave NW",
      "city": "Washington",
      "state": "DC",
      "zip": "20500"
    },
    {
      "id": "esb",
      "street": "350 5th Ave",
      "city": "New York",
      "state": "NY",
      "zip": "10118"
    }
  ]
}

curl

curl -X POST https://gateway.pipeworx.io/census-geocoder/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"census_geocode_batch","arguments":{"addresses":[{"id":"wh","street":"1600 Pennsylvania Ave NW","city":"Washington","state":"DC","zip":"20500"},{"id":"esb","street":"350 5th Ave","city":"New York","state":"NY","zip":"10118"}]}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('census_geocode_batch', {
  "addresses": [
    {
      "id": "wh",
      "street": "1600 Pennsylvania Ave NW",
      "city": "Washington",
      "state": "DC",
      "zip": "20500"
    },
    {
      "id": "esb",
      "street": "350 5th Ave",
      "city": "New York",
      "state": "NY",
      "zip": "10118"
    }
  ]
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "census-geocoder": {
      "url": "https://gateway.pipeworx.io/census-geocoder/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build September 18, 2026

Was this helpful?