{
  "x402Version": 2,
  "id": 51385,
  "slug": "51385",
  "resource": "https://api.locus.report/api/locus-tax-liens",
  "description": "Returns itemized tax-delinquency, tax-lien, and foreclosure rows near an address from official county, treasurer, and sheriff sources, for agents reading cited public records. Use this when you need itemized public lien records and citations. Use locus_tax_distress instead when you only need a nearby count and breakdown, without individual lien records.",
  "type": "http",
  "resourceType": "MCP Tool",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "FBVHMG5PTNW6sNd7uhZBsxhWkwJYRpgk34QcTgDpQdwV",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "address": "1 E Edenton St, Raleigh, NC 27601"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "byType": {
              "delinquent": 50
            },
            "caveats": [
              "Reported public-record tax/foreclosure status near the point - records only, NOT a 'distressed', 'deal', 'buy', or investment characterization or recommendation.",
              "Filings and listings are procedural public records: a listed parcel may be redeemed, dismissed, adjourned, paid, or already sold. Absence of a record is not proof of clear title or no distress.",
              "Owner, redemption, and party names are never returned; parcel id, address, amount owed, status, and date are the only cited fields.",
              "Coverage is county-scoped to wired official sources; other counties return an explicit out_of_coverage, not an empty 'nothing here' result.",
              "Amount owed, status, and date are copied verbatim from the official layer where present; some lists carry no dollar amount, no per-row date, or no street address.",
              "Verify any record with the county treasurer/clerk/sheriff of record before acting - this is a due-diligence pointer, not a title search or legal determination."
            ],
            "coverage": "covered",
            "distressTypesPresent": [
              "delinquent"
            ],
            "matched": true,
            "nearbyCount": 50,
            "note": "FREE preview: coverage + a nearby count + a distress-type breakdown only. The itemized records (site address, amount owed, parcel id, status, date, citation) are the paid locus-tax-liens lookup ($0.01, POST /api/locus-tax-liens; same query, full public-record rows, PII-safe - no owner names). Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
            "ok": true,
            "paidLookup": {
              "priceUsdc": "0.01",
              "returns": "itemized public-record rows (site address, amount owed, parcel id, status, date, citation); PII-safe, no owner names",
              "route": "POST /api/locus-tax-liens",
              "tool": "locus-tax-liens"
            },
            "point": {
              "latitude": 35.780418000003195,
              "longitude": -78.63910200000142
            },
            "radiusMeters": 1500,
            "resolvedCounty": {
              "county": "Wake County",
              "state": "NC"
            },
            "sourceStatus": [],
            "sources": [
              {
                "coverage": "ok",
                "distressType": "delinquent",
                "fetchMode": "mirror",
                "sourceName": "Wake County Tax Administration - Delinquent Real Estate Taxes",
                "sourceUrl": "https://www.wake.gov/departments-government/tax-administration",
                "syncedAt": "2026-07-05T01:54:21.058Z"
              }
            ]
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "additionalProperties": false,
                "properties": {
                  "address": {
                    "maxLength": 200,
                    "minLength": 5,
                    "type": "string"
                  },
                  "distressTypes": {
                    "items": {
                      "enum": [
                        "delinquent",
                        "tax_lien_sale",
                        "tax_foreclosure",
                        "mortgage_foreclosure",
                        "sheriff_sale",
                        "tax_auction",
                        "land_forfeiture"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "latitude": {
                    "maximum": 90,
                    "minimum": -90,
                    "type": "number"
                  },
                  "longitude": {
                    "maximum": 180,
                    "minimum": -180,
                    "type": "number"
                  },
                  "radiusMeters": {
                    "maximum": 8000,
                    "minimum": 100,
                    "type": "integer"
                  }
                },
                "type": "object"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "builder-code": {
      "info": {
        "a": "bc_vz5zyuko"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "maxItems": 11,
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "locus.freePreflight": {
      "coverageBeforeCharge": true,
      "laneTool": "locus_lane_availability",
      "mcpUrl": "https://mcp.locus.report/mcp",
      "recommendedTool": "locus_coverage_check",
      "skillInstall": "npx @velinussage/locus-agent-skill add",
      "skillUrl": "https://api.locus.report/.well-known/skill.md",
      "toolsCallUrl": "https://api.locus.report/tools/call",
      "toolsListUrl": "https://api.locus.report/tools/list",
      "unsupportedReturnsFreeDiagnostic": true,
      "version": 2
    },
    "offer-receipt": {
      "info": {
        "offers": [
          {
            "acceptIndex": 0,
            "format": "eip712",
            "payload": {
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "network": "eip155:8453",
              "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
              "resourceUrl": "https://api.locus.report/api/locus-tax-liens",
              "scheme": "exact",
              "validUntil": 1791440870,
              "version": 1
            },
            "signature": "0x8462ff5c8a0be15e922e2b425c04073c273952345bbbbceb1b3c7b0feebf358916583a558d7909051d7a11774d7b2c073f62550fbbc8f0adecd83cbabbc2f17e1b"
          }
        ]
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "offers": {
            "items": {
              "properties": {
                "acceptIndex": {
                  "type": "integer"
                },
                "format": {
                  "type": "string"
                },
                "payload": {
                  "properties": {
                    "amount": {
                      "type": "string"
                    },
                    "asset": {
                      "type": "string"
                    },
                    "network": {
                      "type": "string"
                    },
                    "payTo": {
                      "type": "string"
                    },
                    "resourceUrl": {
                      "type": "string"
                    },
                    "scheme": {
                      "type": "string"
                    },
                    "validUntil": {
                      "type": "integer"
                    },
                    "version": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "version",
                    "resourceUrl",
                    "scheme",
                    "network",
                    "asset",
                    "payTo",
                    "amount"
                  ],
                  "type": "object"
                },
                "signature": {
                  "type": "string"
                }
              },
              "required": [
                "format",
                "signature"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "offers"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar",
    "builder-code",
    "locus.freePreflight",
    "offer-receipt"
  ],
  "sourceHost": "api.locus.report",
  "lastUpdated": "2026-10-08T06:26:50.754Z",
  "quality": {
    "calls30d": 4,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T06:26:50.548Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "address": "1 E Edenton St, Raleigh, NC 27601"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "byType": {
                "delinquent": 50
              },
              "caveats": [
                "Reported public-record tax/foreclosure status near the point - records only, NOT a 'distressed', 'deal', 'buy', or investment characterization or recommendation.",
                "Filings and listings are procedural public records: a listed parcel may be redeemed, dismissed, adjourned, paid, or already sold. Absence of a record is not proof of clear title or no distress.",
                "Owner, redemption, and party names are never returned; parcel id, address, amount owed, status, and date are the only cited fields.",
                "Coverage is county-scoped to wired official sources; other counties return an explicit out_of_coverage, not an empty 'nothing here' result.",
                "Amount owed, status, and date are copied verbatim from the official layer where present; some lists carry no dollar amount, no per-row date, or no street address.",
                "Verify any record with the county treasurer/clerk/sheriff of record before acting - this is a due-diligence pointer, not a title search or legal determination."
              ],
              "coverage": "covered",
              "distressTypesPresent": [
                "delinquent"
              ],
              "matched": true,
              "nearbyCount": 50,
              "note": "FREE preview: coverage + a nearby count + a distress-type breakdown only. The itemized records (site address, amount owed, parcel id, status, date, citation) are the paid locus-tax-liens lookup ($0.01, POST /api/locus-tax-liens; same query, full public-record rows, PII-safe - no owner names). Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
              "ok": true,
              "paidLookup": {
                "priceUsdc": "0.01",
                "returns": "itemized public-record rows (site address, amount owed, parcel id, status, date, citation); PII-safe, no owner names",
                "route": "POST /api/locus-tax-liens",
                "tool": "locus-tax-liens"
              },
              "point": {
                "latitude": 35.780418000003195,
                "longitude": -78.63910200000142
              },
              "radiusMeters": 1500,
              "resolvedCounty": {
                "county": "Wake County",
                "state": "NC"
              },
              "sourceStatus": [],
              "sources": [
                {
                  "coverage": "ok",
                  "distressType": "delinquent",
                  "fetchMode": "mirror",
                  "sourceName": "Wake County Tax Administration - Delinquent Real Estate Taxes",
                  "sourceUrl": "https://www.wake.gov/departments-government/tax-administration",
                  "syncedAt": "2026-07-05T01:54:21.058Z"
                }
              ]
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "additionalProperties": false,
                  "properties": {
                    "address": {
                      "maxLength": 200,
                      "minLength": 5,
                      "type": "string"
                    },
                    "distressTypes": {
                      "items": {
                        "enum": [
                          "delinquent",
                          "tax_lien_sale",
                          "tax_foreclosure",
                          "mortgage_foreclosure",
                          "sheriff_sale",
                          "tax_auction",
                          "land_forfeiture"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "latitude": {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    "longitude": {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    },
                    "radiusMeters": {
                      "maximum": 8000,
                      "minimum": 100,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "bodyType": {
                  "enum": [
                    "json",
                    "form-data",
                    "text"
                  ],
                  "type": "string"
                },
                "method": {
                  "enum": [
                    "POST",
                    "PUT",
                    "PATCH"
                  ],
                  "type": "string"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "bodyType",
                "body"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      },
      "builder-code": {
        "info": {
          "a": "bc_vz5zyuko"
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "a": {
              "description": "App builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "s": {
              "description": "Service builder codes",
              "items": {
                "pattern": "^[a-z0-9_]{1,32}$",
                "type": "string"
              },
              "maxItems": 11,
              "type": "array"
            },
            "w": {
              "description": "Wallet builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "locus.freePreflight": {
        "coverageBeforeCharge": true,
        "laneTool": "locus_lane_availability",
        "mcpUrl": "https://mcp.locus.report/mcp",
        "recommendedTool": "locus_coverage_check",
        "skillInstall": "npx @velinussage/locus-agent-skill add",
        "skillUrl": "https://api.locus.report/.well-known/skill.md",
        "toolsCallUrl": "https://api.locus.report/tools/call",
        "toolsListUrl": "https://api.locus.report/tools/list",
        "unsupportedReturnsFreeDiagnostic": true,
        "version": 2
      },
      "offer-receipt": {
        "info": {
          "offers": [
            {
              "acceptIndex": 0,
              "format": "eip712",
              "payload": {
                "amount": "10000",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "network": "eip155:8453",
                "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
                "resourceUrl": "https://api.locus.report/api/locus-tax-liens",
                "scheme": "exact",
                "validUntil": 1791440870,
                "version": 1
              },
              "signature": "0x8462ff5c8a0be15e922e2b425c04073c273952345bbbbceb1b3c7b0feebf358916583a558d7909051d7a11774d7b2c073f62550fbbc8f0adecd83cbabbc2f17e1b"
            }
          ]
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "offers": {
              "items": {
                "properties": {
                  "acceptIndex": {
                    "type": "integer"
                  },
                  "format": {
                    "type": "string"
                  },
                  "payload": {
                    "properties": {
                      "amount": {
                        "type": "string"
                      },
                      "asset": {
                        "type": "string"
                      },
                      "network": {
                        "type": "string"
                      },
                      "payTo": {
                        "type": "string"
                      },
                      "resourceUrl": {
                        "type": "string"
                      },
                      "scheme": {
                        "type": "string"
                      },
                      "validUntil": {
                        "type": "integer"
                      },
                      "version": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "version",
                      "resourceUrl",
                      "scheme",
                      "network",
                      "asset",
                      "payTo",
                      "amount"
                    ],
                    "type": "object"
                  },
                  "signature": {
                    "type": "string"
                  }
                },
                "required": [
                  "format",
                  "signature"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "offers"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.locus.report",
    "manifest_name": "api.locus.report",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}