Korzy API

Build land, energy and infrastructure context into your product, pipeline or agent. Query structured JSON or connect over MCP. Choose a plan to get your API key.

Get API access Read the docs

curl --fail-with-body --silent --show-error --max-time 30 \
  -H "Authorization: Bearer ${KORZY_API_KEY:?Set KORZY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"address": "714 Mordecai Towne Pl, Raleigh, NC", "sections": ["utilities"]}' \
  https://api.korzy.co/v1/lookup

Create a key on your account page.

LookupEnrichRecordAsk

POST /v1/lookup{  "address": "714 Mordecai Towne Pl, Raleigh, NC",  "sections": [    "utilities",    "environment"  ]}

{  "location": {    "address": "714 MORDECAI TOWNE PL, RALEIGH"  },  "parcels": {    "records": [      {        "korzy_id": "37183-676db8ae68362b7a3685",        "parceladdr": "714 MORDECAI TOWNE PL",        "totalvalue": 662832,        "more": …      }    ]  },  "sections": {    "utilities": {      "status": "ok",      "data": {        "water": [          {            "name": "RALEIGH, CITY OF"          }        ],        "sewer": [          {            "name": "NEUSE RIVER RESOURCE RECOVERY FACILITY"          }        ],        "more": …      }    },    "environment": {      "status": "ok",      "data": …    }  },  "credits": {    "charged": 3,    "refunded": 0  }}

POST /v1/enrich{  "items": [    {      "address": "714 Mordecai Towne Pl, Raleigh, NC"    },    {      "korzy_id": "37183-676db8ae68362b7a3685"    },    {      "longitude": -78.627,      "latitude": 35.7999    }  ],  "preset": "basic"}

{  "results": [    {      "index": 0,      "status": "ok",      "records": [        {          "korzy_id": "37183-676db8ae68362b7a3685",          "parcelid": "1714066205",          "countyname": "Wake",          "land_use_code": "RHS",          "more": …        }      ]    },    …  ],  "credits": {    "charged": 3,    "refunded": 0  }}

GET /v1/records/plant:57695

{  "id": "plant:57695",  "type": "power_plant",  "record": {    "plant_name": "Topaz Solar Farm",    "state": "CA",    "county": "San Luis Obispo",    "balancing_authority_code": "CISO",    "grid_voltage_kv": 230,    "generator_count": 5,    "more": …  },  "credits": {    "charged": 1,    "refunded": 0  }}

POST /v1/ask{  "question": "Does this property have public water and sewer, and are there cleanup sites nearby?",  "address": "2304 Hillsborough St, Raleigh, NC"}

{  "answer": "Yes.\n- Public water: the parcel is within the Raleigh, City of water boundary [c2].\n- Public sewer: the parcel is within the Neuse River Resource Recovery Facility sewer boundary [c3].",  "citations": [    {      "ref": "c2",      "id": "utility:water:29943"    },    …  ],  "credits": 10}

Docs

Guides and the full reference. Agents and code generators can load the OpenAPI description.

Credits, limits and errors

What each request costs, rate limits and error codes.

API reference

Every route and field, with example responses.

Credits

Every plan includes monthly credits for the API and MCP server, and you can buy more at your plan’s rate. The field catalog is free, so agents can see what each request returns and costs before they spend.

Credits spent by each kind of request
Request	Credits
A location lookup (address or coordinates) with its parcels	1 credit
Each lookup section: utilities, environment, logistics, data centers, power, grid, parcel boundaries	+1 credit
Each lookup section: terrain	+2 credits
Each address, point or parcel ID in an enrich batch (up to 25 per request)	1 credit
Each enrich item with owner fields (available on request, opt-in per organization)	2 credits
A record by ID: a parcel, power plant, data center, utility or other record	1 credit
A question answered by Ask, with cited sources	10 credits
Support requests and the field catalog	Free

Monthly credits

Professional · 3,000 credits$49 / month
Business · 15,000 credits$199 / month

Credits reset each month, and unused credits carry over once. Compare plans

Everything behind a Korzy answer, one request away

The same records that power Korzy and our research. The API reference covers each endpoint, its parameters and its limits, and the use cases show what teams build with them.

Lookup

The parcels at an address or point, with the utilities, environment, logistics, data-center, power, grid and terrain context you ask for.

Enrich

Selected parcel fields for a batch of addresses, points or parcel IDs in one request. Owner fields are available on request (opt-in per organization).

Records

Any parcel, plant, project, utility or grid record by the ID a lookup returned, with provenance.

Ask

A question about a place, answered from Korzy data with citations, as JSON or streamed.

Plug Korzy into your agent

The agent plugin for Claude Code, Codex and Hermes: one download with a research skill and a complete setup guide. Using Claude or ChatGPT? Follow the connect steps.

The plugin connects to Korzy’s MCP server at https://api.korzy.co/mcp, and you sign in with your Korzy account the first time it connects. To use an API key instead, create one with MCP access on your account page and make it available to your agent as KORZY_API_KEY through your environment or secret manager.

Download the plugin SHA256 checksumVersion 0.4.1

› Connect the Korzy MCP server at https://api.korzy.co/mcp, sign me in, then call list_fields.

MCP docs

Codex

From the extracted korzy-plugin directory, add the local marketplace, then sign in when Codex first connects.

codex plugin marketplace add .
# Or connect with an API key instead of signing in:
codex mcp add korzy --url https://api.korzy.co/mcp \
  --bearer-token-env-var KORZY_API_KEY

Install Korzy from the Korzy marketplace in the desktop app, or enable korzy-research@korzy in your Codex configuration as described in the included guide.

Codex plugin guide

Claude Code

From the extracted directory, launch Claude Code with the package, then sign in from /mcp. Invoke /korzy-research:korzy to use the skill.

claude --plugin-dir ./plugins/korzy

Connect with an API key

Merge this into your project’s .mcp.json, preserving other servers. Restart and check /mcp.

{
  "mcpServers": {
    "korzy": {
      "type": "http",
      "url": "https://api.korzy.co/mcp",
      "headers": {
        "Authorization": "Bearer ${KORZY_API_KEY}"
      }
    }
  }
}

Claude Code MCP guide

Hermes

Copy plugins/korzy into your active profile’s plugins folder as ~/.hermes/plugins/korzy-research.

hermes plugins list
hermes plugins enable korzy-research