Bynn Intelligence

oficial

Detecção de Fraude em Documentos (imagem, PDF)

Ver em bynn.comExperimente este MCPPatrocinado

O que você pode fazer com Bynn Intelligence MCP?

Detectar imagens geradas por IA — Peça ao seu assistente para verificar se uma imagem foi gerada por IA via detect_ai_generated_image, retornando um veredito, probabilidade e o provável gerador.
Executar análise de fraude em documentos — Envie um documento com submit_document para análise completa de autenticidade e, em seguida, consulte get_document até que o relatório forense esteja pronto.
Criar sessões de verificação KYC — Use create_session para iniciar um fluxo de verificação de identidade e obter um link hospedado ou código QR para enviar ao solicitante.
Estimar idade a partir de uma selfie — Chame verify_age_from_selfie para estimar a idade de uma pessoa e verificar contra um limite como 18 ou 21, com detecção de vivacidade opcional.
Pesquisar rostos em coleções — Cadastre rostos com enroll_face e encontre correspondências usando search_faces nas coleções da sua organização.
Gerenciar chaves de API e cobrança — Liste, recupere ou rotacione chaves de API com list_api_keys/rotate_api_key e verifique uso ou faturas por meio das ferramentas de cobrança.

Documentação

Fetch the complete documentation index at: https://docs.bynn.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

Bynn MCP

Conecte qualquer cliente de IA compatível com MCP ao Bynn: verificação de identidade (KYC), detecção de fraude em documentos, verificação de idade, moderação de conteúdo, busca facial, fluxos de trabalho AutoDoc, agentes de raciocínio contra fraude e gerenciamento de conta. 143 ferramentas sobre a API Bynn, uma única conexão. Funciona no Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf e Zed.

https://mcp.bynn.com

O endpoint é o caminho raiz. Não acrescente /mcp; https://mcp.bynn.com/mcp não funcionará. A única outra rota é GET /health.

Início rápido (30 segundos)

Claude Code:

claude mcp add --transport http bynn https://mcp.bynn.com

Claude ou ChatGPT (hospedado): adicione https://mcp.bynn.com como conector personalizado e faça login com sua conta Bynn quando o navegador abrir. Nenhum gerenciamento de chave é necessário.

Clientes estilo API: obtenha um token em dashboard.bynn.com/authenticate e envie-o como Authorization: Bearer <token> na conexão.

Em seguida, tente seu primeiro prompt:

Check whether this image is AI-generated.

Anexe uma imagem, e o resultado é renderizado como um cartão interativo com o veredito, a probabilidade de IA e o gerador mais provável.

Exemplos de prompts

Fraude e documentos

Submit this bank statement for fraud analysis and summarize the risk when it finishes.
Is this invoice manipulated? Show me the forensic findings.
Run my passport-fraud orchestrator against the latest analyzed document.

Verificação

Create a KYC verification session for this applicant and give me the hosted link.
Estimate the age of the person in this photo and tell me if they look under 25.
Create an age verification session with liveness for user 8841.

Moderação e mídia

Check whether this image is AI-generated.
Which moderation models can I run on video?
Search this face against my employees collection.

Conta e operações

List my API keys and when they were last used.
Rotate my live private key but keep the grace period.
Show this month's usage and my latest invoices.

Resultados de fraude em documentos e imagens geradas por IA são renderizados como cartões interativos tanto no ChatGPT quanto no Claude (veja Widgets interativos).

Instalação

Claude Code

claude mcp add --transport http bynn https://mcp.bynn.com

Claude Desktop e claude.ai

Configurações → Conectores → Adicionar conector personalizado → URL https://mcp.bynn.com. O login OAuth inicia automaticamente no primeiro uso.

ChatGPT

Configurações → Apps e Conectores → ative o modo desenvolvedor → Criar → URL do servidor MCP https://mcp.bynn.com. O Bynn é construído como um app ChatGPT: relatórios de fraude e verificações de imagens por IA são renderizados como cartões interativos, e imagens anexadas são encaminhadas às ferramentas nativamente.

Cursor

Um clique acima, ou adicione manualmente a ~/.cursor/mcp.json (ou .cursor/mcp.json por projeto):

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com"
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "bynn": {
      "type": "http",
      "url": "https://mcp.bynn.com"
    }
  }
}

Windsurf

O Windsurf conecta-se por meio da ponte mcp-remote:

{
  "mcpServers": {
    "bynn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
    }
  }
}

Zed

settings.json → context_servers:

{
  "context_servers": {
    "bynn": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
      }
    }
  }
}

Autenticação

OAuth 2.1 (conectores)

Conectores hospedados (Claude, ChatGPT) autenticam com OAuth 2.1 + PKCE. O servidor de autorização é dashboard.bynn.com; seu cliente MCP abre um login no navegador, você aprova as permissões solicitadas, e o cliente conecta-se como seu usuário do painel Bynn. Clientes que suportam Registro Dinâmico de Cliente (Claude, Cursor) registram-se automaticamente.

Tokens Bearer (clientes estilo API)

Para uso no servidor, em scripts ou auto-hospedado, envie um cabeçalho de autorização na conexão MCP:

Authorization: Bearer <token>

Obtenha um token em dashboard.bynn.com/authenticate. Três tipos de token funcionam:

Token	Prefixo	O que pode fazer
Token do painel (JWT)	nenhum	Tudo. Quando uma ferramenta precisa de uma chave de API, o servidor troca o JWT pelas chaves da sua organização automaticamente.
Chave de API privada	`private_...`	Ferramentas de produto e verificação (documentos, moderação, resultados de idade). Não é suficiente para ferramentas do painel, como chaves de API ou cobrança.
Chave de API pública	`public_...`	Criação de sessão segura para cliente (`create_session`, `create_age_verification_session`).

Por grupo de ferramentas:

Grupo de ferramentas	Credencial mínima
Chaves de API, cobrança, usuários, AutoDoc, raciocínio, sites	Token do painel (JWT)
Documentos, moderação, rosto, NFC	Chave privada ou JWT
`create_session`, `create_age_verification_session`	Chave pública ou JWT
`verify_age_from_selfie`, `get_age_verification_result`	Chave privada ou JWT
Etapas de sessão (consentimento, pré-verificação, liveness, uploads)	Nenhuma: o token de sessão na URL é a credencial

Use chaves privadas apenas em ambientes confiáveis no lado do servidor. Nunca as exponha em código de frontend, repositórios públicos ou conversas compartilhadas.

Exemplo de configuração de cliente com um token

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com",
      "headers": {
        "Authorization": "Bearer ${BYNN_API_KEY}"
      }
    }
  }
}

export BYNN_API_KEY="private_your_bynn_key_here"

Referência de ferramentas (143 ferramentas)

Distintivos de acesso: Leitura = seguro, sem mutação. Escrita = cria ou altera dados. Destrutivo = exclui, cancela ou revoga (delete_*, cancel_*, rotate_api_key); mantenha a confirmação habilitada para estas no seu cliente. Cada ferramenta também carrega anotações legíveis por máquina readOnlyHint / destructiveHint, para que clientes MCP possam controlá-las automaticamente.

Documentos (4)

Ferramenta	Acesso	Descrição
`delete_document`	Destrutivo	Excluir um envio de documento.
`get_document`	Leitura	Recuperar um envio de documento e seu resultado de análise forense.
`list_documents`	Leitura	Listar e pesquisar seus envios de documentos.
`submit_document`	Escrita	Enviar um documento para análise completa de fraude / autenticidade.

A análise de documentos é assíncrona: submit_document, depois consulte get_document até que status seja analyzed.

Verificação de Idade (5)

Ferramenta	Acesso	Descrição
`complete_age_verification_liveness`	Escrita	Finalizar uma captura de liveness.
`create_age_verification_session`	Escrita	Criar uma nova sessão de verificação de idade com liveness.
`get_age_verification_result`	Leitura	Ler o resultado de uma sessão de verificação de idade com liveness.
`start_age_verification_liveness`	Escrita	Iniciar a captura de liveness para uma sessão.
`verify_age_from_selfie`	Escrita	Estimar a idade a partir de uma única selfie, sem liveness.

verify_age_from_selfie aceita um limite de age_verification_model (21, 18 e inferior, padrão 18) além de um sinalizador de jurisdição legal_age_21. O fluxo de liveness é: criar sessão → iniciar liveness → concluir liveness → obter resultado.

Moderação de Conteúdo (12)

Ferramenta	Acesso	Descrição
`check_age`	Escrita	Estimar a idade dos rostos em uma imagem (verificação de idade / detecção de menores).
`create_moderation_inference`	Escrita	Executar uma inferência de moderação / detecção de IA.
`detect_ai_generated_image`	Escrita	Verificar se uma imagem é gerada por IA ou uma foto real.
`get_moderation_dashboard_stats`	Leitura	Obter estatísticas do painel de moderação para sua organização.
`get_moderation_inference`	Leitura	Recuperar uma inferência de moderação anterior pelo seu id.
`get_moderation_model`	Leitura	Obter um modelo de moderação com documentação completa.
`list_all_moderation_models`	Leitura	Listar TODOS os modelos públicos de moderação em todos os tipos.
`list_audio_moderation_models`	Leitura	Listar modelos de moderação de ÁUDIO agrupados por categoria.
`list_image_moderation_models`	Leitura	Listar modelos de moderação de IMAGEM agrupados por categoria.
`list_text_moderation_models`	Leitura	Listar modelos de moderação de TEXTO agrupados por categoria.
`list_video_moderation_models`	Leitura	Listar modelos de moderação de VÍDEO agrupados por categoria.
`public_moderation_inference`	Escrita	Executar uma inferência GRATUITA de detecção de IA, sem credencial necessária.

detect_ai_generated_image retorna result.is_ai_generated (o veredito), ai_probability, uncertain, top_generator, generators, c2pa_signer e detection_mode. check_age retorna por rosto age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty e bbox.

Busca Facial (6)

Ferramenta	Acesso	Descrição
`create_face_collection`	Escrita	Criar uma nova coleção de rostos.
`delete_face`	Destrutivo	Excluir um único rosto inscrito de uma coleção.
`delete_face_collection`	Destrutivo	Excluir uma coleção de rostos e TODOS os seus rostos inscritos.
`enroll_face`	Escrita	Inscrever um único rosto em uma coleção.
`list_face_collections`	Leitura	Listar as coleções de rostos da sua organização.
`search_faces`	Leitura	Pesquisar em uma coleção rostos semelhantes a uma imagem de sonda.

AutoDoc (37)

Ferramenta	Acesso	Descrição
`add_dossier_note`	Gravação	Adicionar uma nota administrativa a um dossiê.
`approve_approval`	Gravação	Aprovar uma aprovação HITL pendente.
`attach_dossier_tag`	Gravação	Anexar uma tag da organização a um dossiê.
`create_document_collection`	Gravação	Criar uma coleção de documentos.
`create_invitation`	Gravação	Enviar um convite AutoDoc por e-mail ou SMS.
`create_organization_tag`	Gravação	Criar uma tag da organização.
`create_workflow`	Gravação	Criar um fluxo de trabalho.
`delete_document_collection`	Destrutivo	Excluir uma coleção de documentos (exclusão lógica).
`delete_invitation`	Destrutivo	Cancelar (exclusão definitiva) um convite AutoDoc pendente.
`delete_organization_tag`	Destrutivo	Excluir uma tag da organização.
`delete_workflow`	Destrutivo	Excluir um fluxo de trabalho (exclusão lógica).
`detach_dossier_tag`	Gravação	Desanexar uma tag da organização de um dossiê.
`download_dossier_zip`	Leitura	Empacotar os documentos e variáveis de um dossiê em um ZIP.
`duplicate_workflow`	Gravação	Duplicar um fluxo de trabalho.
`get_autodoc_dashboard_stats`	Leitura	Obter estatísticas agregadas do painel AutoDoc.
`get_document_collection`	Leitura	Obter uma coleção de documentos e seus requisitos.
`get_dossier`	Leitura	Obter um dossiê com progresso e variáveis do fluxo de trabalho.
`get_dossier_form_fields`	Leitura	Listar nomes de campos de formulário disponíveis nos fluxos de trabalho ativos.
`get_invitation`	Leitura	Obter um único convite AutoDoc.
`get_pending_approval_count`	Leitura	Obter a contagem de aprovações HITL pendentes.
`get_workflow`	Leitura	Obter um único fluxo de trabalho.
`list_approvals`	Leitura	Listar aprovações de fluxo de trabalho com intervenção humana.
`list_document_collections`	Leitura	Listar coleções de documentos da sua organização.
`list_document_types`	Leitura	Listar os tipos de documento disponíveis para requisitos de coleção.
`list_dossier_documents`	Leitura	Listar os documentos enviados a um dossiê.
`list_dossier_notes`	Leitura	Listar as notas / linha do tempo de auditoria de um dossiê.
`list_dossiers`	Leitura	Listar e filtrar dossiês AutoDoc.
`list_invitation_locales`	Leitura	Listar idiomas de convite suportados.
`list_invitations`	Leitura	Listar convites AutoDoc.
`list_organization_tags`	Leitura	Listar as tags de dossiê da sua organização.
`list_workflows`	Leitura	Listar fluxos de trabalho da sua organização.
`reject_approval`	Gravação	Rejeitar uma aprovação HITL pendente.
`resend_invitation`	Gravação	Reenviar um convite AutoDoc.
`update_document_collection`	Gravação	Atualizar uma coleção de documentos e (opcionalmente) seus requisitos.
`update_dossier`	Gravação	Renomear um dossiê.
`update_organization_tag`	Gravação	Atualizar a cor e/ou o nome de uma tag da organização.
`update_workflow`	Gravação	Atualizar um fluxo de trabalho.

Agentes de Raciocínio e Fraude (25)

Ferramenta	Acesso	Descrição
`create_fraud_agent`	Gravação	Criar um agente/operador de análise de fraude.
`create_orchestrator`	Gravação	Criar um agente orquestrador (coordenador).
`create_reasoning_job`	Gravação	Enfileirar um trabalho ASSÍNCRONO de raciocínio de fraude para um documento.
`delete_fraud_agent`	Destrutivo	Excluir um agente/operador de análise de fraude.
`delete_orchestrator`	Destrutivo	Excluir um agente orquestrador.
`generate_fraud_agent_prompt`	Gravação	Redigir um prompt de sistema de agente de análise de fraude com IA.
`generate_orchestrator_prompt`	Gravação	Redigir um prompt de sistema de orquestrador com IA.
`get_agent`	Leitura	Obter um único agente (orquestrador ou operador) por token.
`get_agent_stats`	Leitura	Obter estatísticas agregadas de agentes da sua organização.
`get_reasoning_job`	Leitura	Obter o status e os resultados completos de um trabalho de raciocínio.
`list_agent_categories`	Leitura	Listar as opções de categorias de agentes disponíveis.
`list_agent_ratings`	Leitura	Listar avaliações e resumo de avaliações de um agente público.
`list_document_content_types`	Leitura	Listar tipos de conteúdo de documento e quais já estão reivindicados.
`list_fraud_agents`	Leitura	Listar os agentes/operadores de análise de fraude DA SUA organização.
`list_orchestrators`	Leitura	Listar os agentes orquestradores DA SUA organização.
`list_public_fraud_agents`	Leitura	Navegar por modelos públicos de agentes de análise de fraude da comunidade global.
`list_public_orchestrators`	Leitura	Navegar por modelos públicos de orquestradores da comunidade global.
`list_reasoning_jobs`	Leitura	Listar trabalhos de raciocínio com filtros e estatísticas da organização.
`publish_agent`	Gravação	Publicar um dos seus agentes no marketplace público da comunidade.
`rate_agent`	Gravação	Avaliar um agente público com 1 a 5 estrelas.
`reorder_orchestrator_agents`	Gravação	Reordenar os agentes de análise de fraude atribuídos a um orquestrador.
`test_orchestrator`	Gravação	Executar um orquestrador SINCRONAMENTE contra um documento existente.
`unpublish_agent`	Gravação	Remover um dos seus agentes do marketplace público.
`update_fraud_agent`	Gravação	Atualizar um agente/operador de análise de fraude.
`update_orchestrator`	Gravação	Atualizar um agente orquestrador.

Cobrança (14)

Ferramenta	Acesso	Descrição
`cancel_billing_plan`	Destrutivo	Agendar o cancelamento da assinatura atual.
`change_billing_plan`	Gravação	Alterar o plano de assinatura da organização.
`confirm_payment_method`	Gravação	Salvar o cartão confirmado como método de pagamento padrão.
`create_setup_intent`	Gravação	Criar um SetupIntent do Stripe para coletar um método de pagamento.
`download_invoice`	Leitura	Baixar uma fatura em PDF.
`get_billing_info`	Leitura	Obter o snapshot completo de cobrança da organização.
`get_current_usage`	Leitura	Obter o uso não faturado do período de cobrança atual.
`get_stripe_config`	Leitura	Obter a configuração do lado do cliente do Stripe.
`list_billing_plans`	Leitura	Listar todos os planos de assinatura disponíveis com preços e recursos.
`list_inference_history`	Leitura	Listar o histórico de solicitações de inferência/verificação de IA da organização.
`list_invoices`	Leitura	Listar as faturas da organização, das mais recentes para as mais antigas.
`topup_balance`	Gravação	Adicionar fundos pré-pagos ao saldo da conta via cartão salvo.
`update_company_details`	Gravação	Atualizar os dados da empresa/faturamento da organização.
`validate_vat_number`	Leitura	Validar um número de IVA da UE por meio de uma consulta externa.

topup_balance está em dólares americanos, mínimo US$ 10, máximo US$ 10.000 por recarga.

Usuários e Conta (7)

Ferramenta	Acesso	Descrição
`activate_trial`	Gravação	Salvar um método de pagamento e ativar o teste gratuito de 7 dias com crédito de US$ 10.
`add_passkey`	Gravação	Começar a adicionar uma chave de acesso à conta do usuário autenticado: obter opções de criação do WebAuthn.
`delete_passkey`	Destrutivo	Excluir uma das chaves de acesso do usuário autenticado.
`get_current_user`	Leitura	Obter o usuário autenticado, sua organização e estatísticas rápidas da conta.
`list_passkeys`	Leitura	Listar as chaves de acesso registradas do usuário autenticado.
`report_public_data`	Gravação	Reportar dados incorretos no perfil público do usuário autenticado.
`submit_onboarding_survey`	Gravação	Salvar a pesquisa de integração da organização do usuário atual.

Sites (8)

Ferramenta	Acesso	Descrição
`create_website`	Gravação	Criar uma nova configuração de site de verificação de idade.
`delete_website`	Destrutivo	Excluir permanentemente uma configuração de site de verificação de idade.
`get_website`	Leitura	Obter um site de verificação de idade por ID.
`list_countries`	Leitura	Listar todos os países com códigos e atributos.
`list_verifications`	Leitura	Navegar pelo histórico de verificação de idade da organização.
`list_websites`	Leitura	Listar todos os sites de verificação de idade da organização autenticada.
`pause_website`	Gravação	Pausar ou retomar a verificação de idade de um site.
`update_website`	Gravação	Atualizar uma configuração existente de site de verificação de idade.

Verificações Agemin (3)

Ferramenta	Acesso	Descrição
`get_age_verification_status`	Leitura	Reverificar um resultado anterior de verificação de idade no servidor.
`verify_age_with_email`	Escrita	Estimar a idade mínima de uma pessoa a partir do endereço de e-mail.
`verify_age_with_selfie`	Escrita	Estimar a idade de uma pessoa a partir de uma única selfie.

Sessões de Verificação (16)

Ferramenta	Acesso	Descrição
`cancel_session`	Destrutivo	Cancelar / abortar uma sessão.
`check_email_verification`	Leitura	Concluir a verificação de e-mail com o código.
`check_phone_verification`	Leitura	Concluir a verificação de telefone com o código SMS.
`complete_liveness`	Escrita	Concluir uma captura de prova de vida facial.
`create_session`	Escrita	Criar uma nova sessão de verificação de identidade.
`get_session`	Leitura	Exibir informações sobre uma sessão aberta.
`get_session_preflight`	Leitura	Obter a próxima etapa de verificação de uma sessão.
`give_session_consent`	Escrita	Registrar a decisão de consentimento do solicitante.
`send_session_sms`	Escrita	Enviar SMS ao solicitante com um link para continuar no celular.
`start_email_verification`	Escrita	Iniciar a verificação de e-mail enviando um código.
`start_liveness`	Escrita	Iniciar uma captura de prova de vida facial.
`start_phone_verification`	Escrita	Iniciar a verificação de telefone enviando um código por SMS.
`submit_address_verification`	Escrita	Enviar um documento de comprovante de endereço.
`submit_funds_verification`	Escrita	Enviar um documento de comprovante de fundos.
`update_session`	Escrita	Atualizar os dados do solicitante de uma sessão aberta.
`upload_session_media`	Escrita	Enviar mídia capturada para uma sessão.

Chaves de API (3)

Ferramenta	Acesso	Descrição
`get_api_key`	Leitura	Recuperar o valor COMPLETO, sem mascaramento, de uma chave de API existente.
`list_api_keys`	Leitura	Listar todas as chaves de API da organização autenticada.
`rotate_api_key`	Destrutivo	Rotacionar (regenerar) uma chave de API da organização autenticada.

list_api_keys retorna valores mascarados; apenas get_api_key revela o segredo completo, então mantenha a confirmação ativada para ele em contextos compartilhados. rotate_api_key mantém a chave antiga válida por um período de carência de 12 horas por padrão; passe immediate: true para revogá-la instantaneamente.

NFC (1)

Ferramenta	Acesso	Descrição
`submit_nfc_data`	Escrita	Enviar dados de documento de identidade lidos via NFC para uma sessão de verificação.

Servidor e Autodescoberta (2)

Ferramenta	Acesso	Descrição
`describe_api`	Leitura	Retornar a especificação OpenAPI 3.0 da API REST da Bynn (de /openapi.json).
`describe_cli`	Leitura	Retornar instruções de instalação, autenticação e uso da CLI da Bynn (`bynn`).

Widgets interativos

Duas famílias de ferramentas retornam cartões interativos em vez de JSON bruto em hosts que suportam aplicativos MCP (ChatGPT e Claude):

Fraude documental (submit_document, get_document): um cartão de relatório ao vivo com o medidor de risco, sinais forenses, campos extraídos e tags de risco. Análises pendentes se auto-verificam até a conclusão.
Verificação de imagem por IA (detect_ai_generated_image): cartão de veredito com probabilidade de IA e um detalhamento do gerador. Se nenhuma imagem foi fornecida, o cartão renderiza um uploader de arrastar e soltar, e o arquivo solto vai direto para o detector sem entrar no contexto do chat.

Outros clientes MCP simplesmente recebem os mesmos dados como JSON estruturado.

Exemplo de fluxo de trabalho

Uma sessão KYC completa, conduzida conversacionalmente:

1. "Create a verification session for applicant #4471 with my standard KYC level."
   → create_session returns {session_id, dossier_id, url, qr_base64_png, websocket_url}
2. Send the returned `url` to the applicant (or show the QR code).
3. "What's the next step for this session?"
   → get_session_preflight (after give_session_consent) walks each remaining step
4. "Show the session status."
   → get_session, repeated until the flow completes

O padrão assíncrono é o mesmo em todos os lugares: ferramentas de criação retornam um id, ferramentas get_* fazem polling dele. Para fraude documental, submit_document → get_document até status: "analyzed"; para trabalhos de raciocínio, create_reasoning_job → get_reasoning_job.

CLI da Bynn: trabalhe com arquivos locais

O servidor MCP hospedado não pode ler arquivos na sua máquina. A CLI da Bynn pode. Agentes que rodam localmente (Claude Code, Cursor, um terminal) podem analisar arquivos locais diretamente:

bynn submit ./bank-statement.pdf -o json      # full document-fraud analysis, auto-polls
bynn ai-generated ./profile-photo.png -o json # AI-generated-image check

Instalação (macOS/Linux):

brew tap Bynn-Intelligence/bynn
brew install --cask bynn

Instalação (Windows):

scoop bucket add bynn https://github.com/Bynn-Intelligence/scoop-bynn
scoop install bynn

Downloads diretos (além de .deb/.rpm e checksums) estão na página de releases.

Autentique uma vez (bynn auth login armazena a chave no chaveiro do seu sistema operacional), ou de forma não interativa com BYNN_API_KEY, --token ou bynn auth login --with-token. Chaves de sandbox (private_sandbox_...) são reconhecidas automaticamente.

Projetado para ser amigável a agentes: -o json para saída estruturada, --jq para filtragem, --dry-run para pré-visualizar requisições, --poll para resultados assíncronos e um contrato de saída limpo (stdout = dados, stderr = progresso). A árvore de comandos é gerada a partir da especificação OpenAPI ao vivo da Bynn, e bynn api <METHOD> <PATH> é um pass-through autenticado bruto para qualquer endpoint. A CLI cobre sessões, verificação de idade, convites AutoDoc, documentos, moderação, NFC e face; para cobrança, chaves de API, dossiês, orquestradores e sites, use este servidor MCP.

Para agentes: chame a ferramenta describe_cli neste servidor para obter este guia completo em formato legível por máquina.

Autodescoberta para agentes

O servidor se documenta. Se você é um LLM conectado a ele:

describe_api retorna a especificação OpenAPI 3.0 completa da Bynn: cada endpoint, parâmetro e schema, incluindo aqueles não encapsulados como ferramentas MCP. Sem autenticação necessária.
describe_cli retorna um guia estruturado para instalar, autenticar e executar a CLI bynn localmente, para trabalhar com arquivos locais. Sem autenticação necessária.
file://server/status (recurso MCP) retorna a lista de ferramentas ao vivo e o status do servidor.

Estes também são anunciados nas instruções initialize do servidor, então você não precisa deste README para encontrá-los.

Avançado

Anotações e contrato de resposta

Cada ferramenta carrega anotações MCP ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), aplicadas de forma consistente por verbo: get_*/list_*/ search_*/describe_*/download_*/validate_* são somente leitura; delete_*/cancel_*/ rotate_api_key são destrutivas. Falhas retornam como payloads estruturados {error: true, error_type, message} em vez de erros de protocolo, para que agentes possam ler e reagir a eles.

Solução de problemas

Sintoma	Correção
404 / falha de conexão imediata	Você anexou `/mcp` à URL. O endpoint é a raiz: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	Obtenha um token em dashboard.bynn.com/authenticate e defina-o como o cabeçalho `Authorization`. Não tente novamente às cegas.
Uma ferramenta retorna 401 com uma conexão válida	Tipo de credencial errado para aquele grupo de ferramentas; veja a tabela de autenticação. Chaves de API e cobrança precisam de um token do dashboard, não uma chave `private_` bruta.
A ferramenta de imagem diz que nenhuma imagem foi fornecida	O cartão que aparece aceita arrastar e soltar; solte a imagem nele. Ou passe uma `image_url` pública.
Documento preso em `pending`	A análise é assíncrona; faça polling de `get_document` até que `status` seja `analyzed`. Não faça polling mais do que a cada poucos segundos.
Conector OAuth parou de funcionar	Desconecte e reconecte o conector para reexecutar o fluxo de login.

Suporte

Problemas e perguntas: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

Licenciado sob MIT.