Offendersearch

Pesquise todos os 58 registros de ofensores sexuais dos EUA em uma única chamada — correspondências pontuadas com citações de registros oficiais.

Documentação

Servidor MCP Offendersearch

Pesquise em todos os 58 registros de criminosos sexuais dos EUA — todos os estados, DC e territórios — a partir de qualquer cliente MCP: Claude Desktop, Claude Code ou qualquer runtime de agente que fale o Model Context Protocol.

Uma única chamada de ferramenta retorna registros pontuados, deduplicados e com proveniência de um conjunto de dados nacional atualizado continuamente com 100% de cobertura dos EUA. Construído no SDK oficial em Python mcp (FastMCP).

Ferramentas

FerramentaO que faz
search_offendersPesquisa em todos os registros por uma pessoa/local — nome, data de nascimento, idade, cidade/estado/CEP, endereço, raio GIS ou texto livre. Retorna correspondências pontuadas com resultado por registro (sourceStatus) e warnings em linguagem simples.
batch_searchAté 1.000 consultas em uma única chamada, linha por linha, cada uma passando pelo mesmo mecanismo de uma pesquisa individual.
get_registry_coverageO catálogo público de cobertura: código de cada registro, escopo, status legal e saúde. Nenhuma chave de API necessária.

Os resultados trazem matchConfidence, matchBasis (por que correspondeu), estado de verificação da data de nascimento, apelidos, endereços, detalhes da infração e uma citação por fonte com lastCheckedAt — para que um agente possa citar exatamente qual registro disse o quê.

Autenticação — uma chave de API, gratuita para obter

Crie uma chave em offendersearch.app — ela funciona imediatamente: 25 pesquisas gratuitas, sem cartão de crédito.

  • Local (stdio): defina OFFENDERSEARCH_API_KEY.
  • Remoto (streamable-HTTP): cada requisição encaminha seu próprio cabeçalho X-API-Key — multi-tenant por design.

Início 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 / auto-hospedado (streamable-HTTP)

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

Configuração do cliente para uma instância hospedada (chave por requisição, sem segredo de ambiente):

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

Exemplo de troca

Usuário: Um John Doe, nascido em 12/04/1980, está em algum registro em Nova Jersey?

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

Agente: Um candidato correspondeu com confirmação completa da data de nascimento (dobVerification: dob_match, confiança 1.0): John A. Doe, registrado em NJ, com o registro oficial vinculado. Todos os 58 registros foram pesquisados até a conclusão (sourcesIncomplete: 0).

Lendo resultados com responsabilidade

  • Se counts.sourcesIncomplete > 0, os registros são um limite inferior — repasse warnings[0] em vez de relatar um "sem correspondência" limpo.
  • Uma correspondência é um candidato, não uma identificação — verifique data de nascimento e fotografia.
  • Os resultados são dados de registro público e não são um relatório de consumo; não os use para decisões cobertas pela FCRA sem o processo adequado.

Mais

Recursos do Offendersearch