Offendersearch

Busca en los 58 registros de delincuentes sexuales de EE. UU. en una sola llamada: coincidencias puntuadas con citas de registros oficiales.

Documentación

Servidor MCP de Offendersearch

Busca en los 58 registros de delincuentes sexuales de EE. UU. — todos los estados, DC y los territorios — desde cualquier cliente MCP: Claude Desktop, Claude Code, o cualquier runtime de agente que hable el Model Context Protocol.

Una sola llamada de herramienta devuelve registros puntuados, deduplicados y con procedencia verificada de un conjunto de datos nacional actualizado continuamente con cobertura del 100 % en EE. UU. Construido sobre el SDK oficial de Python mcp (FastMCP).

Herramientas

HerramientaQué hace
search_offendersBusca en todos los registros una persona/ubicación — nombre, fecha de nacimiento, edad, ciudad/estado/código postal, dirección, radio GIS o texto libre. Devuelve coincidencias puntuadas con el resultado por registro (sourceStatus) y warnings en lenguaje sencillo.
batch_searchHasta 1,000 consultas en una sola llamada, fila por fila, cada una a través del mismo motor que una búsqueda individual.
get_registry_coverageEl catálogo público de cobertura: cada código de registro, alcance, estado legal y salud. No se necesita clave API.

Los resultados incluyen matchConfidence, matchBasis (por qué coincidió), estado de verificación de fecha de nacimiento, alias, direcciones, detalle del delito y una cita por fuente con lastCheckedAt — para que un agente pueda citar exactamente qué registro dijo qué.

Autenticación — una clave API, gratuita

Crea una clave en offendersearch.app — funciona de inmediato: 25 búsquedas gratuitas, sin tarjeta requerida.

  • Local (stdio): establece OFFENDERSEARCH_API_KEY.
  • Remoto (streamable-HTTP): cada solicitud reenvía su propio encabezado X-API-Key — multiinquilino por diseño.

Inicio rápido (Claude Desktop, stdio local)

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

claude_desktop_config.json:

{
  "mcpServers": {
    "offendersearch": {
      "command": "python",
      "args": ["/path/to/services/mcp-server/server.py"],
      "env": { "OFFENDERSEARCH_API_KEY": "os_live_..." }
    }
  }
}

Remoto / autoalojado (streamable-HTTP)

MCP_TRANSPORT=streamable-http OFFENDERSEARCH_API_KEY="os_live_..." python server.py
# or: uvicorn server:http_app  (see Dockerfile)

Configuración del cliente para una instancia alojada (clave por solicitud, sin secreto de entorno):

{
  "mcpServers": {
    "offendersearch": {
      "url": "https://<your-host>/mcp",
      "headers": { "X-API-Key": "os_live_..." }
    }
  }
}

Ejemplo de intercambio

Usuario: ¿Está un John Doe, nacido el 12-04-1980, en algún registro en Nueva Jersey?

Agentesearch_offenders(first_name="John", last_name="Doe", dob="1980-04-12", state="NJ")

Agente: Un candidato coincidió con confirmación completa de fecha de nacimiento (dobVerification: dob_match, confianza 1.0): John A. Doe, registrado en NJ, con el registro oficial vinculado. Los 58 registros se buscaron hasta completarse (sourcesIncomplete: 0).

Lectura responsable de resultados

  • Si counts.sourcesIncomplete > 0, los registros son un límite inferior — transmite warnings[0] en lugar de informar un "sin coincidencias" limpio.
  • Una coincidencia es un candidato, no una identificación — verifica fecha de nacimiento y fotografía.
  • Los resultados son datos de registro público y no un informe de consumo; no los uses para decisiones cubiertas por FCRA sin el proceso adecuado.

Más

Recursos de Offendersearch