Honest Elf

npx add-mcp 'https://mcp.honestelf.com/mcp'

Servidor MCP Honest Elf

Um servidor remoto de Protocolo de Contexto de Modelo (MCP) que permite que assistentes de IA preparem, enviem e acompanhem peticionamentos eletrônicos judiciais por meio do Honest Elf, um Provedor de Serviços de Peticionamento Eletrônico (EFSP) certificado no Texas. Esta página é a referência para usuários e administradores de TI: como o servidor é conectado, como ele autentica, exatamente o que suas ferramentas podem fazer e como os dados são tratados.

Visão geral

O Honest Elf é um Provedor de Serviços de Peticionamento Eletrônico operado pela Zhakhan LLC. Ele transmite peticionamentos judiciais para os tribunais do Texas por meio do Tyler Technologies Odyssey File & Serve Electronic Filing Manager (EFM) — a mesma infraestrutura exigida pelo estado que todo provedor de peticionamento eletrônico do Texas utiliza. O servidor MCP expõe essa capacidade a clientes de IA compatíveis com MCP (Claude, Claude Code, ChatGPT e agentes personalizados).

Um agente conectado ao servidor age em nome de um usuário do Honest Elf que fez login, dentro do escritório e da jurisdição desse usuário. Ele pode consultar tribunais e suas regras de peticionamento, pesquisar processos existentes no registro do tribunal, montar minutas de peticionamento com documentos PDF, obter uma cotação oficial de taxas, enviar para revisão do serventuário após aprovação explícita do usuário e acompanhar os resultados. Os peticionamentos enviados dessa forma são peticionamentos eletrônicos comuns: os tribunais veem um envio padrão de um EFSP certificado, revisado por um serventuário como qualquer outro.

Detalhes da conexão

Endpoint	https://mcp.honestelf.com/mcp
Transporte	HTTP Streamable
Autenticação	OAuth 2.1 com PKCE e registro dinâmico de cliente
Escopo	efile
Ferramentas	39 (consulte a referência de ferramentas abaixo)
Jurisdição	Tribunais do Texas (todos os tribunais de peticionamento eletrônico atendidos pela Tyler)
Hospedagem	Hospedado na nuvem pelo Honest Elf; TLS em todos os endpoints

Conectando um cliente

Claude.ai / Claude Desktop: adicione um conector personalizado apontando para https://mcp.honestelf.com/mcp (Configurações → Conectores → Adicionar conector personalizado) ou instale-o a partir do diretório de conectores do Claude, se estiver listado lá.

Claude Code:

claude mcp add --transport http honest-elf https://mcp.honestelf.com/mcp

Outros clientes MCP: qualquer cliente que suporte o transporte HTTP Streamable e OAuth 2.1 funciona. O servidor publica metadados padrão de descoberta OAuth; os clientes se registram por meio de registro dinâmico de cliente — não há chaves de API a provisionar ou compartilhar.

No primeiro uso, o cliente abre uma janela do navegador na página de consentimento do Honest Elf. O usuário faz login com sua conta do Honest Elf e aprova o acesso. Ainda não tem conta? O registro está em honestelf.com/register.

Autenticação e controle de acesso

• OAuth por usuário, sem segredos compartilhados. Cada conexão é autorizada por um usuário individual na página de consentimento hospedada pelo Honest Elf. A senha do usuário é inserida apenas nessa página — ela nunca é compartilhada com o cliente de IA, o modelo ou a conversa.
• OAuth 2.1 com PKCE e tokens de atualização rotativos. Os tokens de acesso têm vida curta; os tokens de atualização são rotacionados a cada uso. O único escopo efile cobre as ferramentas desta página e nada mais.
• Limitado ao próprio escritório do usuário. Cada chamada de ferramenta é executada como o usuário autorizador, com as permissões existentes desse usuário. Não há acesso entre escritórios ou administrativo por meio do servidor MCP.
• Revogável a qualquer momento. Os usuários podem revogar o acesso de um agente em sua conta do Honest Elf; a revogação entra em vigor imediatamente. O servidor também suporta revogação padrão de token OAuth.
• Sessões do tribunal são separadas. Se a sessão do usuário com o sistema do tribunal expirar, as ferramentas retornam relink_required com uma URL onde o usuário reautentica — a autorização do próprio agente não é afetada e nunca é ampliada.
• Trilha de auditoria completa. Cada chamada de ferramenta é registrada com o usuário atuante, o escritório e o cliente OAuth. Minutas e peticionamentos criados por agentes aparecem no aplicativo web do Honest Elf, onde uma pessoa pode revisar, editar ou cancelá-los.

O que o servidor pode e não pode fazer

Um agente pode

• Ler configurações do tribunal, taxas e regras de peticionamento
• Pesquisar processos nos tribunais dentro da jurisdição do usuário
• Ler os peticionamentos, advogados, contatos e contas de pagamento mascaradas do escritório
• Criar e editar minutas de peticionamento e anexar PDFs
• Solicitar uma cotação oficial de taxas
• Enviar um peticionamento preparado — somente com o token de confirmação da cotação
• Acompanhar resultados da revisão do serventuário e e-service

Um agente não pode

• Enviar qualquer coisa sem uma cotação de taxas que foi mostrada ao usuário
• Ver números de cartão ou banco (contas de pagamento são referências mascaradas)
• Adicionar ou modificar contas de pagamento, advogados ou usuários do escritório
• Acessar dados de outro escritório ou usuário
• Excluir ou alterar peticionamentos enviados (somente cancelar antes do início da revisão do serventuário)
• Agir após o usuário revogar o acesso

Taxas e o modelo de aprovação

O peticionamento eletrônico custa dinheiro real — taxas judiciais, serviços opcionais, e-service e a taxa do provedor do Honest Elf. O servidor é construído para que nenhuma cobrança possa ocorrer sem que uma pessoa veja o número primeiro:

1. prepare_filing valida a minuta e retorna a cotação oficial e detalhada de taxas do sistema do tribunal, uma URL de revisão onde o usuário pode ler todo o peticionamento preparado em uma página, e um token de confirmação que expira em 15 minutos.
2. submit_filing exige esse token. As instruções do cliente direcionam o agente a mostrar ao usuário o total de taxas e obter aprovação explícita primeiro; o usuário também pode enviar diretamente pela página de revisão.
3. No momento do envio, o servidor reverifica o conteúdo da minuta e revalida as taxas junto ao sistema do tribunal. Se algo mudou desde a cotação, o envio é recusado (fee_changed) e deve ser re-preparado e re-aprovado.
4. Os envios carregam uma chave de idempotência gerada pelo cliente, para que uma chamada repetida nunca possa peticionar — ou cobrar — duas vezes. Se o sistema do tribunal expirar no meio do envio, o servidor relata o estado de incerteza e os clientes reconciliam com sync_filings em vez de reenviar.

Referência de ferramentas

Todas as 39 ferramentas, agrupadas por função. As ferramentas Read apenas retornam dados; as ferramentas Write alteram o estado — quase todas apenas em minutas privadas dentro do Honest Elf. As únicas ferramentas com efeitos colaterais voltados ao tribunal são submit_filing e cancel_filing; prepare_filing solicita uma cotação ao sistema do tribunal, mas não peticiona nada.

Conta

Orientação. Os clientes normalmente chamam whoami primeiro para ver quem está conectado e se o link com o sistema do tribunal está ativo.

Ferramenta	Tipo	O que faz
whoami	Read	Mostra o usuário conectado, o escritório, a jurisdição e se o link de peticionamento eletrônico da Tyler está atualmente ativo (com uma URL de reconexão, se não estiver).

Tribunais e códigos de peticionamento

Consultas somente leitura da configuração de cada tribunal. Cada tribunal define suas próprias categorias de processo, tipos, códigos de peticionamento, papéis das partes e taxas.

Ferramenta	Tipo	O que faz
search_courts	Read	Pesquisa locais de tribunais com peticionamento eletrônico por nome; retorna o court_id usado por todas as outras ferramentas de tribunal.
get_court	Read	Capacidades e regras de peticionamento de um tribunal: caminhos de peticionamento aceitos, regras de serviço e pagamento, campos obrigatórios, tipos de arquivo aceitos.
list_case_categories	Read	Categorias de processo de um tribunal — a primeira escolha de classificação ao peticionar.
list_case_types	Read	Tipos de processo de um tribunal, opcionalmente filtrados por categoria, com taxas básicas de peticionamento.
list_case_subtypes	Read	Códigos de subtipo de processo, para tribunais que exigem um.
list_filing_codes	Read	Códigos de peticionamento disponíveis para um contexto de peticionamento (tribunal + inicial/subsequente + classificação do processo).
get_filing_code_details	Read	Tudo o que é necessário para anexar documentos para um código de peticionamento: componentes, tipos de segurança de documentos e serviços opcionais com taxas.
list_party_types	Read	Códigos de papel das partes de um tribunal, incluindo os papéis que um tipo de processo exige.
list_case_extras	Read	Campos extras dependentes da categoria: valores de danos, opções de procedimento/recurso, tipos de número de referência cruzada.

Consulta de processos ativos

Consultas somente leitura ao registro do tribunal, limitadas aos tribunais na jurisdição do usuário.

Ferramenta	Tipo	O que faz
search_cases	Read	Encontra um processo existente em um tribunal por número do processo, nome da parte ou nome da organização.
get_case	Read	Detalhes completos de um processo existente: códigos de classificação e partes atuais.
get_case_service_contacts	Read	Contatos de serviço vinculados a um processo existente — quem receberia e-service em um peticionamento Serve.

Dados do escritório

Listas somente leitura limitadas ao escritório do usuário conectado. Novas contas de pagamento e advogados não podem ser criados por meio do servidor MCP — somente no aplicativo web do Honest Elf.

Ferramenta	Tipo	O que faz
list_attorneys	Read	Os advogados do escritório registrados no sistema do tribunal, para uso como advogados do peticionamento ou das partes.
list_firm_service_contacts	Read	A lista mestra do escritório de contatos de serviço para e-service.
list_payment_accounts	Read	As contas de pagamento registradas do escritório (mascaradas — sem números de cartão ou banco). Uma minuta referencia uma por id.

Elaboração de minutas

As minutas são cópias de trabalho privadas dentro do Honest Elf. Nada chega ao tribunal até submit_filing. As minutas criadas por agentes são visíveis e editáveis no aplicativo web.

Ferramenta	Tipo	O que faz
create_draft	Write	Cria uma minuta de peticionamento (envelope) com processo, partes, peticionamentos e destinatários de serviço em uma única chamada.
get_draft	Read	Inspeciona uma minuta: processo, partes, peticionamentos com documentos, destinatários de serviço e problemas de validação atuais.
update_draft	Write	Atualiza campos de nível de envelope (conta de pagamento, tipo de peticionador, advogado do peticionamento, comentário, parte responsável pelas taxas).
delete_draft	Write	Exclui uma minuta e seus documentos. Somente minutas — envelopes enviados são registros do tribunal e não podem ser excluídos.
add_filing	Write	Adiciona outro peticionamento a uma minuta existente.
update_filing	Write	Atualiza um peticionamento no local; os documentos enviados são preservados.
remove_filing	Write	Remove um peticionamento (e seus documentos) de uma minuta.
add_party	Write	Adiciona uma parte ao processo de uma minuta.
update_party	Write	Atualiza os campos de uma parte em uma minuta.
remove_party	Write	Remove uma parte de uma minuta (bloqueado enquanto um peticionamento ou o papel de responsável pelas taxas a referenciar).
set_service_recipients	Write	Substitui a lista de destinatários de e-service da minuta.

Documentos

Os PDFs são anexados aos peticionamentos da minuta. O caminho recomendado é um upload fora de banda — uma página de upload no navegador ou uma URL pré-assinada — para que os bytes do arquivo nunca passem pelo modelo de IA. Apenas o pequeno caminho inline envia bytes pela conversa, e ele é limitado a 2 MB.

Ferramenta	Tipo	O que faz
create_document_upload	Write	Inicia um upload fora de banda: retorna uma página de upload no navegador para um humano, ou uma URL PUT pré-assinada para um cliente que tenha o arquivo. Os bytes vão diretamente para o armazenamento criptografado.
finalize_document	Write	Valida um PDF enviado via URL pré-assinada e o anexa ao peticionamento.
upload_document	Write	Upload inline para PDFs pequenos (máx. 2 MB, base64 pelo modelo). Para qualquer coisa maior, use create_document_upload.
remove_document	Write	Remove um documento enviado de um peticionamento da minuta; o arquivo é excluído do armazenamento.

Preparar, enviar e cancelar

As únicas ferramentas que tocam o sistema do tribunal ativo com efeitos colaterais. O envio está vinculado a uma cotação de taxas que o usuário viu — consulte o modelo de aprovação acima.

Ferramenta	Tipo	O que faz
prepare_filing	Write	Validação no lado do servidor mais a cotação oficial de taxas do sistema do tribunal. Retorna um detalhamento de taxas itemizado, uma URL de revisão para o usuário e um token de confirmação válido por 15 minutos.
submit_filing	Write	Envia um envelope preparado ao tribunal. Exige o token de confirmação, uma chave de idempotência e reverifica as taxas no momento do envio.
cancel_filing	Write	Cancela um envelope enviado antes de o serventuário começar a revisá-lo.

Status e e-service

Os peticionamentos são revisados de forma assíncrona pelos serventuários do tribunal. Essas ferramentas acompanham os resultados; as do tipo atualização releem o estado do sistema do tribunal, mas não alteram nada nele.

Ferramenta	Tipo	O que faz
list_filings	Leitura	Lista os envelopes do escritório — rascunhos ou histórico de envios.
get_filing_status	Leitura	Status atual de um envelope (aceito / rejeitado / em análise, comentários do funcionário), atualizado ao vivo pelo sistema do tribunal.
sync_filings	Escrita	Concilia a lista de arquivamentos local com o sistema do tribunal: importa envelopes arquivados em outro lugar e atualiza os resultados do funcionário.
get_filing_documents	Leitura	Links de download para os documentos de um envelope enviado, conforme o tribunal os possui — cópias com carimbo de arquivamento após aceitação.
list_service_notifications	Leitura	E-service do tribunal que o escritório recebeu, do mais recente ao mais antigo.

Tratamento de dados e segurança

• O que flui para onde. Os dados de arquivamento (detalhes do caso, partes, documentos) são transmitidos ao Tyler EFM e, em seguida, ao tribunal de destino — esse é o propósito do produto. Os detalhes de pagamento são inseridos diretamente nas páginas do processador de pagamento do tribunal; o Honest Elf e o servidor MCP lidam apenas com referências mascaradas e valores de taxas.
• Documentos podem contornar o modelo. Os caminhos de upload recomendados (página de upload do navegador ou URL pré-assinada de create_document_upload) enviam os bytes do arquivo diretamente para o armazenamento de objetos criptografado — eles nunca entram na conversa de IA. O caminho inline existe para arquivos pequenos (≤ 2 MB) e é explicitamente rotulado como passando pelo modelo.
• Criptografia. TLS em trânsito em todos os endpoints; documentos em repouso em armazenamento de objetos criptografado; as credenciais do sistema do tribunal do usuário são armazenadas criptografadas e usadas apenas para autenticação contra o EFM.
• Registro e retenção. Chamadas de ferramentas são registradas para segurança, cobrança e solução de problemas. Detalhes de coleta e retenção — incluindo documentos e dados de caso — estão na política de privacidade, que cobre o servidor MCP explicitamente.
• Supervisão humana. Tudo o que um agente cria é visível no aplicativo web do Honest Elf sob a mesma conta, para que advogados supervisores e funcionários possam revisar a atividade do agente sem ferramentas adicionais.

Códigos de erro

Erros de ferramenta são objetos JSON com um code estável e um caminho de recuperação, para que os agentes falhem de forma previsível em vez de adivinhar. Os códigos mais importantes:

Código	Significado
validation_failed	O rascunho tem problemas; cada problema é listado para que possa ser corrigido com as ferramentas de edição.
fee_changed	As taxas mudaram entre a cotação e o envio. O envio é recusado; execute prepare_filing novamente e obtenha a aprovação do usuário novamente.
confirmation_expired	O token de confirmação de 15 minutos expirou ou o rascunho mudou desde a cotação. Execute prepare_filing novamente.
relink_required	A sessão do usuário no sistema do tribunal expirou. Inclui a URL onde o usuário reautentica; nenhuma reautorização do agente é necessária.
submission_pending_verification	O sistema do tribunal expirou no meio do envio; o arquivamento pode ter sido concluído. Os clientes não devem reenviar — sync_filings reconcilia o resultado.

Suporte

Perguntas sobre conexão, aprovação do servidor para uma organização ou qualquer coisa nesta página: entre em contato com o suporte. Perguntas sobre privacidade: [email protected].

Veja também: Visão geral do servidor MCP · Política de privacidade · Termos de serviço · Visão geral legível por máquina (llms.txt)