Korzy API

Structured JSON and an MCP server over the same records behind Korzy research. Pay as you go, with volume pricing applied automatically.

Get API access View pricing

curl --fail-with-body --silent --show-error --max-time 30 \
  -H "Authorization: Bearer ${KORZY_API_KEY:?Set KORZY_API_KEY}" \
  https://api.korzy.co/api/query/catalog

Create a key on your account page.

Pay as you go

No subscription and no minimum. Usage is billed monthly, and the rate drops as your volume grows.

API price per 1,000 requests by monthly volume
Monthly volume	Per 1,000 requests
First 100,000 requests	$8
100,001 to 1,000,000 requests	$5
Over 1,000,000 requests	Contact us

Estimate a month

10,000 requests$80
100,000 requests$800
500,000 requests$2,800

The first 100,000 requests each month are billed at the first rate, the rest at the second.

What you can query

The API reference in the plugin download covers each endpoint, its parameters and its limits.

Discovery

List datasets with their coverage, fields and query options before you request records.

Parcels and places

Query parcels and the terrain, utilities and infrastructure around a location.

Projects

Search data center projects by state, status and operator, with dated milestones.

Paging and usage

Paginate large results and check your usage for the current month.

Agent plugin and MCP

One download with the same research skill for Codex, Claude Code and Hermes, plus a complete setup guide. Using ChatGPT or Claude on the web? Use the Korzy app

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.2.1

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

Connect with an API key

Merge this into your active profile’s config.yaml, usually ~/.hermes/config.yaml. Restart, then use skills_list to find the Korzy skill.

mcp_servers:
  korzy:
    url: "https://api.korzy.co/mcp"
    headers:
      Authorization: "Bearer ${KORZY_API_KEY}"

Hermes MCP guide

To check the connection, ask your agent to call Korzy’s list_datasets. You should receive the available coverage and query information.