Skip to content
Eden Engine

US Coordinates to Tract, County and FIPS Codes

usgeocoder/coordinates-to-geographies

Returns the US geographic areas that contain a longitude and latitude (vintage Current_Current): state, county, county subdivision, tract, block, place, urban area, congressional district and more, each with its GEOID, name, area and centroid. A point outside the United States answers 200 with an empty `geographies` object (not an error). Coordinates are WGS84 decimal degrees.

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.

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

// 2. inspect: price and input schema
omnial_inspect({ tool: "usgeocoder/coordinates-to-geographies" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgeocoder/coordinates-to-geographies", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgeocoder/coordinates-to-geographies", 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.

ChargePrice
Per call
$0.0026
Updated
Oct 25, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "x",
    "y"
  ],
  "properties": {
    "x": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude in decimal degrees, -180 to 180 (negative in the United States), for example -76.92748."
    },
    "y": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude in decimal degrees, -90 to 90, for example 38.84601."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "required": [
        "geographies"
      ],
      "properties": {
        "input": {
          "type": "object",
          "properties": {
            "vintage": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Vintage id."
                },
                "isDefault": {
                  "type": "boolean"
                },
                "vintageName": {
                  "type": "string",
                  "description": "Vintage name."
                },
                "vintageDescription": {
                  "type": "string",
                  "description": "Vintage description."
                }
              },
              "description": "The vintage used (Current_Current).",
              "additionalProperties": true
            },
            "location": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number",
                  "description": "Longitude sent."
                },
                "y": {
                  "type": "number",
                  "description": "Latitude sent."
                }
              },
              "description": "The point 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
        },
        "geographies": {
          "type": "object",
          "description": "Geographic layers that contain the point, keyed by layer name (states, counties, tracts, blocks, places and more). Each value is a list of records with GEOID, NAME, area and centroid fields. Empty object when the point is outside the United States.",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          }
        }
      },
      "description": "The areas containing the point.",
      "additionalProperties": true
    }
  },
  "description": "Geocoding Services envelope.",
  "additionalProperties": true
}