Anweshna MCP

O que você recebe de volta é triagem de risco, não due diligence. A Anweshna pontua documentos em 15 categorias de risco e sinaliza o que um revisor deve analisar. Ela não realiza verificação independente nem pesquisa primária. Trate um resultado limpo como "nada apareceu neste documento", nunca como "este negócio está limpo".

Autenticação

Toda solicitação carrega sua chave de API, seja como um cabeçalho X-API-Key ou como Authorization: Bearer <key>. As chaves são emitidas no cadastro e entregues por e-mail; membros da equipe obtêm suas próprias subchaves pelo portal, que carregam a função desse membro.

curl https://anweshna.com/api/v1/documents/usage \
  -H "X-API-Key: your-key-here"

As chaves nunca devem aparecer em uma URL — não há fallback por parâmetro de consulta, porque URLs acabam em logs de acesso, histórico do navegador e cabeçalhos Referer.

Servidor MCP

O endpoint MCP é https://anweshna.com/mcp/, usando o transporte HTTP transmissível. Aponte qualquer cliente compatível com MCP para ele e passe sua chave de API como cabeçalho.

{
  "mcpServers": {
    "anweshna": {
      "url": "https://anweshna.com/mcp/",
      "headers": { "X-API-Key": "your-key-here" }
    }
  }
}

O servidor não tem estado, então não há sessão para manter ativa nem requisito de afinidade — cada chamada é independente.

Ferramentas MCP

Ferramenta	O que faz
screen_document	Envie um documento e pontue-o. Passe o arquivo como content_base64 (PDF, DOCX, TXT, CSV) ou como text simples. Retorna a pontuação geral, classificação, sinalizador de bloqueio e descobertas por categoria.
get_analysis	Busca a análise armazenada de um documento que esta conta já triou. Somente leitura.
bulk_screen	Envie e pontue até 25 documentos em um único lote. Aguarda a extração de texto, depois inicia a pontuação e retorna IDs de trabalho; consulte get_bulk_status até o lote terminar. Se essa espera expirar, chame novamente com bulk_job_id em vez de documents para pontuar o lote que você já enviou — reenviar gastaria sua cota duas vezes.
get_bulk_status	Consulta um lote iniciado por bulk_screen até que ele termine.

Um documento grande ou excepcionalmente denso é roteado automaticamente para o mecanismo Deep Scan paralelo por partes. Quando isso acontece, screen_document retorna status: "processing" com um identificador de trabalho em vez de bloquear — consulte get_analysis até o status mudar.

Endpoints REST

As ferramentas MCP são uma camada fina sobre estes. Use-os diretamente para trabalho servidor a servidor.

Endpoint	Finalidade
POST /api/v1/documents/upload	Envie um único documento (multipart).
POST /api/v1/analysis/{document_id}	Pontue um documento enviado.
GET /api/v1/analysis/{document_id}	Recupere uma análise armazenada.
POST /api/v1/documents/bulk-upload	Envie até 25 documentos.
POST /api/v1/analysis/bulk-analyze	Pontue um lote.
GET /api/v1/documents/usage	Plano atual, cota e recursos habilitados.
GET /api/v1/reports/{document_id}/download	Baixe um relatório (Markdown, JSON, PDF ou DOCX, sujeito ao plano).

Esta é a superfície suportada externamente. A Anweshna não publica um esquema OpenAPI gerado em produção: ele exporia rotas administrativas, de cobrança e internas junto com estas, e é por isso que /docs está desabilitado lá.

Erros que você deve tratar

Nunca trate uma varredura falha como resultado limpo. Os estados abaixo significam que a pontuação não ocorreu. Pelo MCP, cada um chega como um erro explícito de ferramenta, não como uma lista vazia de descobertas — trate-os, em vez de relatar o documento como limpo.

Status	Significado	O que fazer
402	Assinatura inativa, ou a cota de upload do plano foi esgotada.	Renove ou faça upgrade. Tentar novamente não ajudará.
403	A função da chave não permite isso — visualizadores não podem enviar.	Use uma chave com a função correta.
422	O documento é grande ou denso demais para ser pontuado em uma única passada.	Execute o Deep Scan, ou reenvie com force_precision para aceitar uma varredura truncada. A resposta indica qual se aplica.
503	O mecanismo de pontuação estava indisponível.	Reenvie o documento. Tentar a mesma solicitação inalterada falha da mesma forma.

Planos e limites

A API e o servidor MCP estão disponíveis em todos os planos pagos. Lotes são limitados a 25 documentos por solicitação. Volume de upload, número de salas de negociação e formatos de exportação variam por plano — veja preços, ou chame GET /api/v1/documents/usage para ler os valores atuais da sua própria conta.

Pelo MCP, o tamanho da solicitação limita antes da contagem de documentos. Arquivos viajam codificados em base64 dentro da solicitação JSON-RPC, e o base64 adiciona cerca de um terço, então uma única chamada screen_document — ou um lote inteiro bulk_screen — deve permanecer abaixo de 32 MB no total, aproximadamente 24 MB de documento real. Envie menos arquivos, porém maiores, por lote, em vez de preencher todos os 25 slots. Uma solicitação acima desse limite é recusada pelo transporte com HTTP 413 antes de a ferramenta rodar, então chega como um erro HTTP bruto em vez de um erro normal de ferramenta. Os endpoints REST aceitam até 50 MB por arquivo e são a rota certa para qualquer coisa maior.

Limites de taxa se aplicam por conta. Documentos e seu texto extraído são criptografados em repouso com uma chave por cliente, e cada gravação é registrada no seu log de auditoria.

Hospedando o servidor MCP você mesmo? Se você executa a Anweshna atrás do seu próprio domínio, defina MCP_ALLOWED_HOSTS para esse domínio. O transporte MCP valida o cabeçalho Host como proteção contra rebinding de DNS e rejeita qualquer coisa não listada com um 421, que não se assemelha nem a uma falha de autenticação nem de roteamento.