`hud_crosswalk`

Pack: hud · Endpoint: https://gateway.pipeworx.io/hud/mcp

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

Map ZIP codes to census tracts, counties, CBSAs, and congressional districts. Returns geographic identifiers. Use to translate between location code formats or join datasets.

Parameters

Name	Type	Required	Description
`type`	number	yes	Crosswalk type: 1=ZIP-to-tract, 2=ZIP-to-county, 3=ZIP-to-CBSA, 4=ZIP-to-congressional-district, 7=county-to-ZIP.
`query`	string	yes	Input value: ZIP code (for types 1-4), or FIPS county code (for type 7). Example: “90210” or “06037”.
`_apiKey`	string	yes	HUD API token

Example call

Arguments

{
  "type": 1,
  "query": "90210",
  "_apiKey": "your-hud-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/hud/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hud_crosswalk","arguments":{"type":1,"query":"90210","_apiKey":"your-hud-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('hud_crosswalk', {
  "type": 1,
  "query": "90210",
  "_apiKey": "your-hud-api-key"
});

More examples

{
  "type": 7,
  "query": "06037",
  "_apiKey": "your-hud-api-key"
}

Response shape

Always returns: crosswalk_type, query, data

Field	Type	Description
`crosswalk_type`	string	Human-readable crosswalk type label
`query`	string	Input query value provided in request
`data`	object	Geographic crosswalk mapping data from HUD API

Full JSON Schema

{
  "type": "object",
  "properties": {
    "crosswalk_type": {
      "type": "string",
      "description": "Human-readable crosswalk type label"
    },
    "query": {
      "type": "string",
      "description": "Input query value provided in request"
    },
    "data": {
      "type": "object",
      "description": "Geographic crosswalk mapping data from HUD API"
    }
  },
  "required": [
    "crosswalk_type",
    "query",
    "data"
  ]
}

Connect

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

{
  "mcpServers": {
    "hud": {
      "url": "https://gateway.pipeworx.io/hud/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hud_crosswalk