US Address Geocoder: Address to Coordinates

usgeocoder/geocode-oneline

Geocodes a one-line US street address against the federal address ranges (benchmark Public_AR_Current): returns each match with the normalised address, longitude and latitude, the TIGER/Line street segment and the address split into parts. An address with no match answers 200 with an empty `addressMatches` list (not an error). Does not return tract, county or FIPS codes: use geocode-with-geographies for those.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

U.S. Census Bureau

Data from the U.S. Census Bureau Geocoding Services, U.S. Department of Commerce. Terms: https://www.census.gov/data/developers/about/terms-of-service.html (attribution required; no re-identification of individuals). Served by Eden Engine. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "usgeocoder/geocode-oneline" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "usgeocoder/geocode-oneline" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgeocoder/geocode-oneline", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgeocoder/geocode-oneline", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "A US street address on one line, 1 to 100 characters, for example 4600 Silver Hill Rd, Washington, DC 20233."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "required": [
        "addressMatches"
      ],
      "properties": {
        "input": {
          "type": "object",
          "properties": {
            "address": {
              "type": "object",
              "properties": {
                "address": {
                  "type": "string",
                  "description": "The address as sent."
                }
              },
              "description": "The address sent.",
              "additionalProperties": true
            },
            "benchmark": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Benchmark id."
                },
                "isDefault": {
                  "type": "boolean"
                },
                "benchmarkName": {
                  "type": "string",
                  "description": "Benchmark name."
                },
                "benchmarkDescription": {
                  "type": "string",
                  "description": "Benchmark description."
                }
              },
              "description": "The benchmark used (Public_AR_Current).",
              "additionalProperties": true
            }
          },
          "description": "The query as the service understood it.",
          "additionalProperties": true
        },
        "addressMatches": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "matchedAddress",
              "coordinates"
            ],
            "properties": {
              "tigerLine": {
                "type": "object",
                "properties": {
                  "side": {
                    "type": "string",
                    "description": "Street side, L or R."
                  },
                  "tigerLineId": {
                    "type": "string",
                    "description": "TIGER/Line edge id."
                  }
                },
                "description": "The street segment matched.",
                "additionalProperties": true
              },
              "coordinates": {
                "type": "object",
                "properties": {
                  "x": {
                    "type": "number",
                    "description": "Longitude."
                  },
                  "y": {
                    "type": "number",
                    "description": "Latitude."
                  }
                },
                "description": "Matched location in WGS84 (x longitude, y latitude).",
                "additionalProperties": true
              },
              "matchedAddress": {
                "type": "string",
                "description": "The address as the geocoder normalised it."
              },
              "addressComponents": {
                "type": "object",
                "properties": {
                  "zip": {
                    "type": "string",
                    "description": "ZIP code."
                  },
                  "city": {
                    "type": "string",
                    "description": "City."
                  },
                  "state": {
                    "type": "string",
                    "description": "State abbreviation."
                  },
                  "preType": {
                    "type": "string",
                    "description": ""
                  },
                  "toAddress": {
                    "type": "string",
                    "description": "End of the matched address range."
                  },
                  "streetName": {
                    "type": "string",
                    "description": "Street name."
                  },
                  "suffixType": {
                    "type": "string",
                    "description": "Street suffix, e.g. RD."
                  },
                  "fromAddress": {
                    "type": "string",
                    "description": "Start of the matched address range."
                  },
                  "preDirection": {
                    "type": "string",
                    "description": ""
                  },
                  "preQualifier": {
                    "type": "string",
                    "description": ""
                  },
                  "suffixDirection": {
                    "type": "string",
                    "description": ""
                  },
                  "suffixQualifier": {
                    "type": "string",
                    "description": ""
                  }
                },
                "description": "The matched address split into parts.",
                "additionalProperties": true
              }
            },
            "description": "One address match.",
            "additionalProperties": true
          },
          "description": "Matches, best first; empty when the address is not found."
        }
      },
      "description": "The geocoding result.",
      "additionalProperties": true
    }
  },
  "description": "Geocoding Services envelope.",
  "additionalProperties": true
}