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
| Ferramenta | O que faz |
|---|---|
search_offenders | Pesquisa 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_search | Até 1.000 consultas em uma única chamada, linha por linha, cada uma passando pelo mesmo mecanismo de uma pesquisa individual. |
get_registry_coverage | O 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?
Agente →
search_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 — repassewarnings[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
- Documentação da API: https://offendersearch.app/docs
- OpenAPI: https://offendersearch.app/openapi.json
- Página MCP: https://offendersearch.app/mcp-server
Recursos do Offendersearch
- Pesquisa de registro de criminosos sexuais — pesquise todos os registros dos EUA em um único painel, com plano gratuito incluído
- Estatísticas de criminosos sexuais por estado — contagens classificadas e taxas por 1.000 residentes para todas as 56 jurisdições dos EUA
- Downloads de dados abertos — CSVs agregados gratuitos (por estado e por cidade)
- Documentação da API de verificação de antecedentes — referência REST, esquema de registro normalizado, guias de início rápido
- Guias de registros estaduais — como funciona o registro de cada estado e como pesquisá-lo
- Guia do servidor MCP — endpoint hospedado, configuração do conector Claude Desktop e ChatGPT
- Preços da API — medido, US$ 0,15 por chamada, faixas de volume