MCP server

Korzy's MCP server gives AI agents the same operations as the API, as six tools they can call. It uses the Streamable HTTP transport at:

https://api.korzy.co/mcp

Connect

Sign-in. Clients that support OAuth open a Korzy sign-in page the first time they connect. Approve access and the client keeps its own token; no key is needed.

API key. For automation, or clients without sign-in, create a key with the mcp:read scope on your account page and send it as a bearer token. Keep it in an environment variable or secret manager, never in a prompt or a committed file.

Claude Code

Add to your project's .mcp.json:

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

Codex

codex mcp add korzy --url https://api.korzy.co/mcp \
  --bearer-token-env-var KORZY_API_KEY

Other clients

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

Using Claude or ChatGPT? Follow the connect steps for Claude and ChatGPT. Our agent plugin for Claude Code, Codex and Hermes bundles the server with a research skill.

Verify

Ask your agent to call list_fields. It's free, and a working connection returns the lookup sections, enrich fields and credits.

Tools

Tool	Returns
`lookup`	The parcels at an address or point and any lookup sections (utilities, environment, logistics, datacenters, power, grid, terrain, boundary). Same credits as `POST /v1/lookup`.
`enrich`	Selected parcel fields for up to 25 addresses, points or parcel IDs; the only way to get owner fields, at 2 credits per item. Same credits as `POST /v1/enrich`.
`get_record`	One record by the `id` a lookup or enrich returned. Same credits as `GET /v1/records/{id}`.
`ask`	A question about one place, answered from Korzy data with citations. 10 credits.
`support_request`	Report missing or wrong data, request a feature or report a bug. Free.
`list_fields`	Lookup sections, enrich fields and presets, record types, credits and limits. Free.

Each tool runs the matching API operation and takes the same inputs. Its full input schema is available from your client's tool list. support_request opens a support request; every other tool only reads.

Usage

Each tool call spends the same credits as the API request it makes, from the same balance, including refunds for failed items or sections. See Credits.
Tool calls count toward your per-minute rate limit.
Errors come back as tool results with isError: true and a message your agent can act on.