{"serverId":"mcp-registry/app.offendersearch/offendersearch","tools":[{"name":"batch_search","fixed":{"name":"batch_search","description":"Run many person/location lookups in one call (row-in / row-out).\n\n    Each row goes through the SAME engine as search_offenders, so a row's records\n    are identical to what a single search would return. A row that fails is\n    reported with status='error' in place and never aborts the batch. Max 1000 rows.\n\n    Returns: { count, results: [ { index, status, counts{records,sourcesQueried,\n    sourcesIncomplete}, warnings: [str], records: [Record], error? } ] } in input\n    order. ★ A row with `co","inputSchema":{"type":"object","title":"batch_searchArguments","required":["queries"],"properties":{"match":{"enum":["strict","balanced","broad"],"type":"string","title":"Match","default":"balanced","description":"Fuzzy tolerance applied to every row (see search_offenders)."},"queries":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Queries","description":"List of query objects (max 1000). Each may set any of: firstName, lastName, dob (YYYY-MM-DD), age, city, state, zipcode, address, lat, lng, radiusMiles, q. One row in = one result out, in input order."},"extensive":{"type":"boolean","title":"Extensive","default":false,"description":"Request extensive detail (offenses[], stateData, images) for every row."},"freshness":{"enum":["daily","weekly"],"type":"string","title":"Freshness","default":"daily","description":"Cache/pricing tier applied to every row: daily=<=24h (default), weekly=<=7d."},"jurisdictions":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Jurisdictions","default":null,"description":"Registry codes applied to EVERY row (e.g. ['FL','TX']). Omit = all 58 registries."},"location_scoped":{"type":"boolean","title":"Location Scoped","default":false,"description":"Apply per-state scoping to every row (see search_offenders)."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":519,"tokensAfter":519},{"name":"get_criminal_coverage","fixed":{"name":"get_criminal_coverage","description":"List the criminal-record jurisdictions searched, with kind and status.\n\n    Use it to discover which states and counties are reachable and which are\n    answering today, before relying on an empty result. Depth is uneven by design:\n    counties publish independently, so a state with many county jurisdictions is\n    not \"better covered\" than one that publishes a single statewide source — it is\n    differently structured.\n\n    Returns the jurisdiction roster; each entry carries its code, the state","inputSchema":{"type":"object","title":"get_criminal_coverageArguments","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":180,"tokensAfter":180},{"name":"get_registry_coverage","fixed":{"name":"get_registry_coverage","description":"List every registry we cover plus its scope, legal status, and health.\n\n    Public coverage catalog (no API key required). Use it to discover the\n    `jurisdictions` codes accepted by search_offenders / batch_search and to\n    check per-registry freshness/health before relying on a result.\n\n    Returns: { count, registries: [ SourceInfo ] } where each SourceInfo is:\n      - id: registry code (e.g. 'IL', 'TX', 'PR')\n      - name: human-readable registry name\n      - covers: [state codes] a regist","inputSchema":{"type":"object","title":"get_registry_coverageArguments","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":180,"tokensAfter":180},{"name":"map_viewport","fixed":{"name":"map_viewport","description":"Get what to draw for one map view: clusters, pins, or named pins.\n\n    Send the view as `bbox`, or as `lat` + `lng` + `radius_miles`. The detail\n    returned depends on the zoom the view is answered at (the response states it\n    in `zoom`):\n      - zoom 3-12  -> mode 'clusters': a count per grid cell. Each cluster has\n        `count`, `bbox`, `breakdown` and `expansionZoom` (fit the map to `bbox` at\n        that zoom and the cluster comes apart).\n      - zoom 13-14 -> mode 'pins': one pin per a","inputSchema":{"type":"object","title":"map_viewportArguments","properties":{"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat","default":null,"description":"Latitude of the centre, instead of bbox (send with lng and radius_miles)."},"lng":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng","default":null,"description":"Longitude of the centre, instead of bbox (send with lat and radius_miles)."},"bbox":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bbox","default":null,"description":"The view as 'west,south,east,north' in degrees, e.g. '-83.5,39.6,-82.4,40.3'. Any size. Send this OR lat/lng with radius_miles, not both."},"zoom":{"anyOf":[{"type":"number","maximum":22,"minimum":0},{"type":"null"}],"title":"Zoom","default":null,"description":"Optional map zoom, 0 to 22. Decides the detail: 3-12 clusters, 13-14 pins without names, 15+ pins with names. Omit it and the zoom is worked out from the size of the view."},"detail":{"enum":["full","count"],"type":"string","title":"Detail","default":"full","description":"full = clusters or pins (default); count = numbers only."},"housing":{"anyOf":[{"type":"array","items":{"enum":["housed","homeless","incarcerated"],"type":"string"}},{"type":"null"}],"title":"Housing","default":null,"description":"Keep only people with one of these housing statuses."},"sandbox":{"type":"boolean","title":"Sandbox","default":false,"description":"If true, answer in test mode: made-up people (labels start with 'Sample') in the real response shape. Needs no plan and is never billed."},"street_only":{"type":"boolean","title":"Street Only","default":false,"description":"If true, keep only people with an exact street address."},"radius_miles":{"anyOf":[{"type":"number","maximum":100,"minimum":0.1},{"type":"null"}],"title":"Radius Miles","default":null,"description":"Radius in miles around lat/lng, 0.1 to 100."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":677,"tokensAfter":677},{"name":"search_criminal","fixed":{"name":"search_criminal","description":"Search US criminal records — county jail bookings, state prison custody, court cases and warrants.\n\n    Covers county jail rosters, statewide prison systems, court sources, warrant\n    systems and statewide registries across the states, DC and the territories,\n    plus the federal layer — which is a separate system holding offences no state\n    search will surface.\n\n    A surname is REQUIRED. Supply firstName and a DOB or birth year wherever you\n    have them: a bare common surname returns thous","inputSchema":{"type":"object","title":"search_criminalArguments","required":["lastName"],"properties":{"age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age","default":null,"description":"Approximate current age, when neither DOB nor birth year is known."},"dob":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dob","default":null,"description":"Date of birth, YYYY-MM-DD. The single strongest disambiguator."},"limit":{"anyOf":[{"type":"integer","maximum":200,"minimum":1},{"type":"null"}],"title":"Limit","default":null,"description":"Max records to return. Default 50."},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","default":null,"description":"2-letter state code (e.g. 'TX'). Narrows to that state's jurisdictions."},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County","default":null,"description":"County name, to narrow within a state."},"lastName":{"type":"string","title":"Lastname","description":"REQUIRED surname. The criminal corpus refuses an unbounded query — a name is the field that cannot be enumerated."},"birthYear":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Birthyear","default":null,"description":"Birth year alone, when a full DOB is unknown."},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname","default":null,"description":"Given name. Strongly recommended: a bare common surname returns thousands."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":550,"tokensAfter":550},{"name":"search_offenders","fixed":{"name":"search_offenders","description":"Search US sex-offender registries for one person and/or location.\n\n    Fans out across all 58 registries (or the ones named in `jurisdictions`),\n    de-duplicates people across registries, scores each match, and returns the\n    normalized records. Supply whatever identifiers you have — all args are\n    optional but at least a name, location, or free-text `q` should be given.\n\n    Returns a SearchResponse object (docs/openapi.yaml / FIELD-DICTIONARY.md):\n      - status: 'complete' | 'partial'  (p","inputSchema":{"type":"object","title":"search_offendersArguments","properties":{"q":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q","default":null,"description":"Free-text search across name/alias/address/city/state/zip (all tokens must appear)."},"age":{"anyOf":[{"type":"integer","maximum":130,"minimum":0},{"type":"null"}],"title":"Age","default":null,"description":"Age filter, used when DOB is unknown. Matched +/-1 year for birthday drift."},"dob":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dob","default":null,"description":"Date of birth 'YYYY-MM-DD'. Improves match precision; drives dobVerification (dob_match / year_match)."},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat","default":null,"description":"Latitude for a GIS radius search (pair with lng)."},"lng":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng","default":null,"description":"Longitude for a GIS radius search (pair with lat)."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":null,"description":"Residence city filter."},"match":{"enum":["strict","balanced","broad"],"type":"string","title":"Match","default":"balanced","description":"Fuzzy tolerance: strict=exact; balanced=nicknames/variants/initials/typos on first name, exact last; broad=also prefix/typo on last name."},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","default":null,"description":"2-letter state/territory code (e.g. 'IL', 'PR'), or the full name. A residence FILTER — it does NOT change which registries run; all 58 are still searched. It filters as a UNION: a record is kept when it has an address in that state OR that state's registry is the one holding it. Each record carries `registrationState` and `addressStates` so you can tell which half matched; for the registration half alone, pass `jurisdictions` instead."},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null,"description":"Fuzzy street-address filter (every token must appear in some record address)."},"zipcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zipcode","default":null,"description":"Residence ZIP (first 5 digits used)."},"extensive":{"type":"boolean","title":"Extensive","default":false,"description":"If true, request extensive detail (retains offenses[], stateData, images). A light call drops them."},"freshness":{"enum":["daily","weekly"],"type":"string","title":"Freshness","default":"daily","description":"Cache/pricing tier: daily=<=24h (default), weekly=<=7d."},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","default":null,"description":"Surname — the primary match key, e.g. 'Smith'."},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","default":null,"description":"Given name, e.g. 'John'."},"deadline_ms":{"type":"integer","title":"Deadline Ms","default":120000,"description":"Max time to wait, in ms (default 120000 / 2 min). Lower for a faster bounded response; partial results return status='partial'.","exclusiveMinimum":0},"radius_miles":{"anyOf":[{"type":"number","maximum":100,"exclusiveMinimum":0},{"type":"null"}],"title":"Radius Miles","default":null,"description":"GIS radius in miles around lat/lng. Defaults to 1 when a point is given; capped at 100."},"jurisdictions":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Jurisdictions","default":null,"description":"Registry codes to query (e.g. ['IL','TX']). Omit/null = ALL 58 registries. See get_registry_coverage for codes."},"location_scoped":{"type":"boolean","title":"Location Scoped","default":false,"description":"OPT-IN ONLY, and never inferred from `state`. If true AND a state is set, run only the registries covering that state instead of all 58. It is a cost knob that COSTS RECALL: anyone registered by another state's registry while residing in the requested state is excluded (7.0% of records). The response reports counts.sourcesSkippedByScope and a NARROWED SEARCH warning when it applies. Leave it false unless the caller explicitly wants the cheaper, narrower search."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":1300,"tokensAfter":1300}],"toolsChanged":6,"tokensSaved":0,"todo":[],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}