> ## Documentation Index
> Fetch the complete documentation index at: https://develop.cotality.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CLIP tools
> Resolve any US property to a CLIP (Cotality integrated property ID) — the universal numeric identifier used as input to all Cotality property data tools.
**What CLIP is:** A unique, persistent numeric identifier assigned by Cotality to every US property parcel — residential and commercial. CLIP is the required input for [Property characteristics](/mcp/property-data/tools/property-characteristics), [Climate risk analytics](/mcp/property-data/tools/climate-risk-analytics), and [Analytics](/mcp/market-trend-analytics/tools/analytics). Always call a CLIP tool first when starting from an address.
**Data capabilities:**
| Tool | Input | Returns | Use cases |
| ------------------------------------ | ------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `clip-find_property_by_clip` | CLIP identifier | Address, APN, owner name, geocode, parcel details | Cross-reference by CLIP, ownership lookup, coordinate resolution |
| `clip-find_property_by_full_address` | Full street address | CLIP + address, APN, owner name, geocode, parcel details | Address-to-CLIP resolution, address validation, mortgage and appraisal workflows |
**Data scope:**
| Attribute | Value |
| ------------ | ---------------------------------------------------------------------------------------------- |
| **Coverage** | All US property parcels — residential and commercial |
| **Output** | Response envelope — `success`, `data` (array of `PropertyData`), `count`, `messages` |
| **Note** | A CLIP query may return multiple records when one parcel maps to more than one property record |
***
## `clip-find_property_by_clip`
Retrieve comprehensive property data using a CLIP identifier.
CLIP is a unique, persistent identifier assigned by Cotality to each property in the United States.
**When to use:**
* You have a CLIP identifier and need detailed property information
* Looking up property ownership, address, parcel numbers (APN), or geographic coordinates
* Cross-referencing properties across different systems using CLIP as the key
**Examples:**
* *"Get property details for CLIP 123456789"*
* *"Find owner information for CLIP 456789123"*
### Input schema
| Parameter | Type | Required | Description |
| --------- | -------- | -------- | ---------------------------------------------- |
| `clip` | `string` | Yes | A numeric CLIP identifier (e.g. `"123456789"`) |
The provided CLIP must be a non-empty string consisting only of numeric characters.
### Example request
```json theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "clip-find_property_by_clip",
"arguments": {
"clip": "123456789"
}
}
}
```
### Output schema
The response envelope is shared by both CLIP tools. See [Response envelope](#response-envelope) and [PropertyData fields](#propertydata-fields) below.
The response includes an array of property records, because multiple properties may share the same CLIP in certain scenarios.
***
## `clip-find_property_by_full_address`
Retrieve comprehensive property data using a complete street address.
This tool performs address-based property lookup when you have a full address but not the CLIP identifier.
**When to use:**
* You have a street address and need property details
* Converting addresses to CLIP identifiers for further processing
* Looking up property ownership by address
**Examples:**
* *"Find property data for 123 Main Street, Los Angeles, CA 90001"*
* *"Get CLIP and owner info for 456 Oak Avenue, Apt 2B, Chicago, IL 60601"*
### Input schema
| Parameter | Type | Required | Description |
| -------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `full_address` | `string` | Yes | Full street address — ideally including street number and name, unit/apartment (if applicable), city, state, and ZIP code |
Full address must be a valid, non-empty string. The more complete and accurate the address, the better the match. Returns an array of property records as fuzzy matching may return multiple candidates.
### Example request
```json theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "clip-find_property_by_full_address",
"arguments": {
"full_address": "123 Main Street, Los Angeles, CA 90001"
}
}
}
```
### Output schema
The response envelope is shared by both CLIP tools. See [Response envelope](#response-envelope) and [PropertyData fields](#propertydata-fields) below.
***
## Response envelope
Both tools return an identical envelope:
| Field | Type | Description |
| ---------- | --------------------- | ------------------------------------------ |
| `success` | `boolean` | Whether the request completed successfully |
| `data` | `array[PropertyData]` | Array of matching property records |
| `count` | `integer` | Number of records in `data` |
| `messages` | `array[string]` | Informational or warning messages |
All four fields are **always present** in every response.
***
## PropertyData fields
Each object in the `data` array is a `PropertyData` record. All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| --------------------------- | ------------------- | ------------------------------------------- |
| `clip` | `string` | CoreLogic Integrated Property identifier |
| `clipStatus` | `string` | Status of the CLIP record |
| `countyCode` | `string` | FIPS county code |
| `county` | `string` | County name |
| `apnUnformatted` | `string` | Assessor Parcel Number — raw, unformatted |
| `apnFormatted` | `string` | Assessor Parcel Number — formatted |
| `previousApnUnformatted` | `string` | Previous APN (before parcel replatting) |
| `alternateApn` | `string` | Alternate APN on file |
| `universalParcelId` | `string` | Universal Parcel ID |
| `apnSequenceNumber` | `integer` | APN sequence number |
| `addressId` | `integer` | Internal address identifier |
| `addressStatus` | `string` | Status of the address record |
| `fullAddress` | `string` | Full assembled address string |
| `addressLine` | `string` | Street address line |
| `cityLine` | `string` | City/state/zip line |
| `houseNumber` | `string` | House / street number |
| `streetNamePrefixDirection` | `string` | Street directional prefix (e.g. "N", "SW") |
| `streetNamePrefix` | `string` | Street name prefix |
| `streetNameBase` | `string` | Base street name |
| `streetName` | `string` | Street name |
| `streetNameSuffix` | `string` | Street suffix (e.g. "St", "Ave") |
| `streetNameSuffixDirection` | `string` | Street directional suffix |
| `streetNameFull` | `string` | Fully assembled street name |
| `unitType` | `string` | Unit type (e.g. "APT", "STE") |
| `unitNumber` | `string` | Unit / apartment number |
| `city` | `string` | City name |
| `uspsRecommendedCity` | `string` | USPS-recommended city name |
| `state` | `string` | State abbreviation |
| `zipCode` | `string` | 5-digit ZIP code |
| `zipPlus4` | `string` | ZIP+4 code |
| `countryCode` | `string` | Country code |
| `streetSide` | `string` | Side of street (e.g. "L", "R") |
| `unitRangeHigh` | `string` | High end of unit range |
| `unitRangeLow` | `string` | Low end of unit range |
| `latitude` | `number` | Latitude coordinate |
| `longitude` | `number` | Longitude coordinate |
| `owner1Name` | `string` | Primary owner name |
| `owner2Name` | `string` | Secondary owner name |
| `matchCode` | `string` | Match code indicating address match quality |
| `propertyMatchScore` | `integer` | Numeric match score |
| `addressAttributes` | `AddressAttributes` | Nested address-level detail (see below) |
### AddressAttributes
The optional `addressAttributes` nested object contains additional address-level and geocoding detail. All fields are optional, nullable, and default to `null`.
| Field | Type | Description |
| --------------------------- | ------- | -------------------------------- |
| `addressId` | integer | Internal address identifier |
| `addressStatus` | string | Status of the address record |
| `addressType` | string | Address type classification |
| `fullAddress` | string | Full assembled address |
| `addressLine` | string | Street address line |
| `cityLine` | string | City/state/zip line |
| `houseNumber` | string | House / street number |
| `streetNamePrefixDirection` | string | Street directional prefix |
| `streetNamePrefix` | string | Street name prefix |
| `streetNameBase` | string | Base street name |
| `streetName` | string | Street name |
| `streetNameSuffix` | string | Street suffix |
| `streetNameSuffixDirection` | string | Street directional suffix |
| `streetNameFull` | string | Fully assembled street name |
| `unitNumber` | string | Unit / apartment number |
| `unitType` | string | Unit type |
| `city` | string | City name |
| `uspsRecommendedCity` | string | USPS-recommended city name |
| `state` | string | State abbreviation |
| `zipCode` | string | 5-digit ZIP code |
| `zipPlus4` | string | ZIP+4 code |
| `countryCode` | string | Country code |
| `streetSide` | string | Side of street |
| `unitRangeHigh` | string | High end of unit range |
| `unitRangeLow` | string | Low end of unit range |
| `addressMatchDescription` | string | Human-readable match description |
| `addressMatchRecord` | string | Matched record identifier |
| `addressMatchCode` | string | Address match code |
| `matchCode` | string | Overall match code |
| `latitude` | number | Latitude coordinate |
| `longitude` | number | Longitude coordinate |
| `geocodeDataSet` | string | Geocoding dataset used |
| `geocodeVendor` | string | Geocoding vendor name |
| `admin1` | string | Administrative division level 1 |
| `admin2` | string | Administrative division level 2 |
| `admin3` | string | Administrative division level 3 |
| `admin4` | string | Administrative division level 4 |
| `admin5` | string | Administrative division level 5 |
| `admin6` | string | Administrative division level 6 |
| `admin7` | string | Administrative division level 7 |
### Sample response
```json theme={null}
{
"success": true,
"count": 1,
"data": [
{
"clip": "123456789",
"clipStatus": "A",
"countyCode": "06037",
"county": "Los Angeles",
"apnUnformatted": "4321012034",
"apnFormatted": "4321-012-034",
"previousApnUnformatted": null,
"alternateApn": null,
"universalParcelId": "06037-4321-012-034",
"apnSequenceNumber": 1,
"addressId": 100200300,
"addressStatus": "A",
"fullAddress": "123 MAIN ST, LOS ANGELES, CA 90001",
"addressLine": "123 MAIN ST",
"cityLine": "LOS ANGELES, CA 90001",
"houseNumber": "123",
"streetNamePrefixDirection": null,
"streetNamePrefix": null,
"streetNameBase": "MAIN",
"streetName": "MAIN",
"streetNameSuffix": "ST",
"streetNameSuffixDirection": null,
"streetNameFull": "MAIN ST",
"unitType": null,
"unitNumber": null,
"city": "LOS ANGELES",
"uspsRecommendedCity": "LOS ANGELES",
"state": "CA",
"zipCode": "90001",
"zipPlus4": "1234",
"countryCode": "US",
"streetSide": null,
"unitRangeHigh": null,
"unitRangeLow": null,
"latitude": 34.0522,
"longitude": -118.2437,
"owner1Name": "SAMPLE OWNER",
"owner2Name": null,
"matchCode": "E01",
"propertyMatchScore": 100,
"addressAttributes": {
"addressId": 100200300,
"addressStatus": "A",
"addressType": "PRIMARY",
"fullAddress": "123 MAIN ST, LOS ANGELES, CA 90001",
"addressLine": "123 MAIN ST",
"cityLine": "LOS ANGELES, CA 90001",
"houseNumber": "123",
"streetNamePrefixDirection": null,
"streetNamePrefix": null,
"streetNameBase": "MAIN",
"streetName": "MAIN",
"streetNameSuffix": "ST",
"streetNameSuffixDirection": null,
"streetNameFull": "MAIN ST",
"unitNumber": null,
"unitType": null,
"city": "LOS ANGELES",
"uspsRecommendedCity": "LOS ANGELES",
"state": "CA",
"zipCode": "90001",
"zipPlus4": "1234",
"countryCode": "US",
"streetSide": null,
"unitRangeHigh": null,
"unitRangeLow": null,
"addressMatchDescription": "Exact match",
"addressMatchRecord": null,
"addressMatchCode": "E01",
"matchCode": "E01",
"latitude": 34.0522,
"longitude": -118.2437,
"geocodeDataSet": "PARCEL",
"geocodeVendor": "COTALITY",
"admin1": "CA",
"admin2": "Los Angeles",
"admin3": null,
"admin4": null,
"admin5": null,
"admin6": null,
"admin7": null
}
}
],
"messages": []
}
```