Bynn Intelligence

oficial

Detección de fraude documental (imagen, PDF)

Ver en bynn.comPrueba este MCPPatrocinado

¿Qué puedes hacer con Bynn Intelligence MCP?

Detectar imágenes generadas por IA — Pídele a tu asistente que verifique si una imagen fue generada por IA mediante detect_ai_generated_image, devolviendo un veredicto, probabilidad y el posible generador.
Ejecutar análisis de fraude documental — Envía un documento con submit_document para un análisis completo de autenticidad y luego consulta get_document hasta que el informe forense esté listo.
Crear sesiones de verificación KYC — Usa create_session para iniciar un flujo de verificación de identidad y obtener un enlace alojado o código QR para enviar al solicitante.
Estimar la edad a partir de una selfie — Llama a verify_age_from_selfie para estimar la edad de una persona y compararla con un umbral como 18 o 21, con verificación de vida opcional.
Buscar rostros en colecciones — Inscribe rostros con enroll_face y encuentra coincidencias usando search_faces contra las colecciones de tu organización.
Gestionar claves API y facturación — Lista, recupera o rota claves API con list_api_keys/rotate_api_key, y consulta el uso o las facturas mediante las herramientas de facturación.

Documentación

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

Conecta cualquier cliente de IA compatible con MCP a Bynn: verificación de identidad (KYC), detección de fraude documental, verificación de edad, moderación de contenido, búsqueda facial, flujos de trabajo AutoDoc, agentes de razonamiento contra fraude y gestión de cuentas. 143 herramientas sobre la API de Bynn, una sola conexión. Funciona en Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf y Zed.

https://mcp.bynn.com

El endpoint es la ruta raíz. No agregues /mcp; https://mcp.bynn.com/mcp no funcionará. La única otra ruta es GET /health.

Inicio rápido (30 segundos)

Claude Code:

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

Claude o ChatGPT (alojado): agrega https://mcp.bynn.com como conector personalizado e inicia sesión con tu cuenta de Bynn cuando se abra el navegador. No es necesario gestionar claves.

Clientes estilo API: obtén un token en dashboard.bynn.com/authenticate y envíalo como Authorization: Bearer <token> en la conexión.

Luego prueba tu primer prompt:

Check whether this image is AI-generated.

Adjunta una imagen y el resultado se renderiza como una tarjeta interactiva con el veredicto, la probabilidad de IA y el generador más probable.

Prompts de ejemplo

Fraude y 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.

Verificación

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.

Moderación y medios

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

Cuenta y operaciones

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.

Los resultados de fraude documental e imágenes de IA se renderizan como tarjetas interactivas tanto en ChatGPT como en Claude (consulta Widgets interactivos).

Instalación

Claude Code

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

Claude Desktop y claude.ai

Configuración → Conectores → Agregar conector personalizado → URL https://mcp.bynn.com. El inicio de sesión OAuth comienza automáticamente en el primer uso.

ChatGPT

Configuración → Apps y conectores → habilita el modo desarrollador → Crear → URL del servidor MCP https://mcp.bynn.com. Bynn está construido como una app de ChatGPT: los informes de fraude y las verificaciones de imágenes de IA se renderizan como tarjetas interactivas, y las imágenes adjuntas se reenvían a las herramientas de forma nativa.

Cursor

Un clic arriba, o agrégalo manualmente a ~/.cursor/mcp.json (o .cursor/mcp.json por proyecto):

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

VS Code (GitHub Copilot)

.vscode/mcp.json:

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

Windsurf

Windsurf se conecta a través del puente 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"]
      }
    }
  }
}

Autenticación

OAuth 2.1 (conectores)

Los conectores alojados (Claude, ChatGPT) se autentican con OAuth 2.1 + PKCE. El servidor de autorización es dashboard.bynn.com; tu cliente MCP abre un inicio de sesión en el navegador, apruebas los permisos solicitados y el cliente se conecta como tu usuario del panel de Bynn. Los clientes que admiten Dynamic Client Registration (Claude, Cursor) se registran automáticamente.

Tokens Bearer (clientes estilo API)

Para uso en servidor, mediante scripts o autoalojado, envía un encabezado de autorización en la conexión MCP:

Authorization: Bearer <token>

Obtén un token en dashboard.bynn.com/authenticate. Funcionan tres tipos de token:

Token	Prefijo	Qué puede hacer
Token de panel (JWT)	ninguno	Todo. Cuando una herramienta necesita una clave de API, el servidor intercambia el JWT por las claves de tu organización automáticamente.
Clave de API privada	`private_...`	Herramientas de producto y verificación (documentos, moderación, resultados de edad). No es suficiente para herramientas del panel como claves de API o facturación.
Clave de API pública	`public_...`	Creación de sesiones seguras para el cliente (`create_session`, `create_age_verification_session`).

Por grupo de herramientas:

Grupo de herramientas	Credencial mínima
Claves de API, facturación, usuarios, AutoDoc, razonamiento, sitios web	Token de panel (JWT)
Documentos, moderación, rostro, NFC	Clave privada o JWT
`create_session`, `create_age_verification_session`	Clave pública o JWT
`verify_age_from_selfie`, `get_age_verification_result`	Clave privada o JWT
Pasos de sesión (consentimiento, preflight, liveness, cargas)	Ninguna: el token de sesión en la URL es la credencial

Usa claves privadas solo en entornos de servidor de confianza. Nunca las expongas en código de frontend, repositorios públicos o chats compartidos.

Ejemplo de configuración de cliente con un token

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

export BYNN_API_KEY="private_your_bynn_key_here"

Referencia de herramientas (143 herramientas)

Insignias de acceso: Lectura = seguro, sin mutación. Escritura = crea o cambia datos. Destructivo = elimina, cancela o revoca (delete_*, cancel_*, rotate_api_key); mantén la confirmación habilitada para estas en tu cliente. Cada herramienta también lleva anotaciones legibles por máquina readOnlyHint / destructiveHint, para que los clientes MCP puedan controlarlas automáticamente.

Documentos (4)

Herramienta	Acceso	Descripción
`delete_document`	Destructivo	Eliminar un envío de documento.
`get_document`	Lectura	Recuperar un envío de documento y su resultado de análisis forense.
`list_documents`	Lectura	Listar y buscar tus envíos de documentos.
`submit_document`	Escritura	Enviar un documento para análisis completo de fraude / autenticidad.

El análisis de documentos es asíncrono: submit_document, luego consulta get_document hasta que status sea analyzed.

Verificación de edad (5)

Herramienta	Acceso	Descripción
`complete_age_verification_liveness`	Escritura	Finalizar una captura de liveness.
`create_age_verification_session`	Escritura	Crear una nueva sesión de verificación de edad con liveness.
`get_age_verification_result`	Lectura	Leer el resultado de una sesión de verificación de edad con liveness.
`start_age_verification_liveness`	Escritura	Iniciar la captura de liveness para una sesión.
`verify_age_from_selfie`	Escritura	Estimar la edad a partir de una sola selfie, sin liveness.

verify_age_from_selfie toma un umbral age_verification_model (21, 18 y menores, por defecto 18) más un indicador de jurisdicción legal_age_21. El flujo de liveness es: crear sesión → iniciar liveness → completar liveness → obtener resultado.

Moderación de contenido (12)

Herramienta	Acceso	Descripción
`check_age`	Escritura	Estimar la edad de los rostros en una imagen (verificación de edad / detección de menores).
`create_moderation_inference`	Escritura	Ejecutar una inferencia de moderación / detección de IA.
`detect_ai_generated_image`	Escritura	Verificar si una imagen es generada por IA o es una foto real.
`get_moderation_dashboard_stats`	Lectura	Obtener estadísticas del panel de moderación para tu organización.
`get_moderation_inference`	Lectura	Recuperar una inferencia de moderación anterior por su id.
`get_moderation_model`	Lectura	Obtener un modelo de moderación con documentación completa.
`list_all_moderation_models`	Lectura	Listar TODOS los modelos públicos de moderación de todos los tipos.
`list_audio_moderation_models`	Lectura	Listar modelos de moderación de AUDIO agrupados por categoría.
`list_image_moderation_models`	Lectura	Listar modelos de moderación de IMAGEN agrupados por categoría.
`list_text_moderation_models`	Lectura	Listar modelos de moderación de TEXTO agrupados por categoría.
`list_video_moderation_models`	Lectura	Listar modelos de moderación de VIDEO agrupados por categoría.
`public_moderation_inference`	Escritura	Ejecutar una inferencia pública GRATUITA de detección de IA, sin credencial requerida.

detect_ai_generated_image devuelve result.is_ai_generated (el veredicto), ai_probability, uncertain, top_generator, generators, c2pa_signer y detection_mode. check_age devuelve por rostro age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty y bbox.

Búsqueda facial (6)

Herramienta	Acceso	Descripción
`create_face_collection`	Escritura	Crear una nueva colección de rostros.
`delete_face`	Destructivo	Eliminar un solo rostro inscrito de una colección.
`delete_face_collection`	Destructivo	Eliminar una colección de rostros y TODOS sus rostros inscritos.
`enroll_face`	Escritura	Inscribir un solo rostro en una colección.
`list_face_collections`	Lectura	Listar las colecciones de rostros de tu organización.
`search_faces`	Lectura	Buscar en una colección rostros similares a una imagen de prueba.

AutoDoc (37)

Herramienta	Acceso	Descripción
`add_dossier_note`	Escritura	Agregar una nota de administrador a un expediente.
`approve_approval`	Escritura	Aprobar una aprobación HITL pendiente.
`attach_dossier_tag`	Escritura	Adjuntar una etiqueta de organización a un expediente.
`create_document_collection`	Escritura	Crear una colección de documentos.
`create_invitation`	Escritura	Enviar una invitación de AutoDoc por correo electrónico o SMS.
`create_organization_tag`	Escritura	Crear una etiqueta de organización.
`create_workflow`	Escritura	Crear un flujo de trabajo.
`delete_document_collection`	Destructivo	Eliminar una colección de documentos (eliminación suave).
`delete_invitation`	Destructivo	Cancelar (eliminación definitiva) una invitación de AutoDoc pendiente.
`delete_organization_tag`	Destructivo	Eliminar una etiqueta de organización.
`delete_workflow`	Destructivo	Eliminar un flujo de trabajo (eliminación suave).
`detach_dossier_tag`	Escritura	Desvincular una etiqueta de organización de un expediente.
`download_dossier_zip`	Lectura	Empaquetar los documentos y variables de un expediente en un ZIP.
`duplicate_workflow`	Escritura	Duplicar un flujo de trabajo.
`get_autodoc_dashboard_stats`	Lectura	Obtener estadísticas agregadas del panel de AutoDoc.
`get_document_collection`	Lectura	Obtener una colección de documentos y sus requisitos.
`get_dossier`	Lectura	Obtener un expediente con progreso y variables de flujo de trabajo.
`get_dossier_form_fields`	Lectura	Listar los nombres de campos de formulario disponibles en tus flujos de trabajo activos.
`get_invitation`	Lectura	Obtener una invitación de AutoDoc individual.
`get_pending_approval_count`	Lectura	Obtener el número de aprobaciones HITL pendientes.
`get_workflow`	Lectura	Obtener un flujo de trabajo individual.
`list_approvals`	Lectura	Listar las aprobaciones de flujos de trabajo con intervención humana.
`list_document_collections`	Lectura	Listar las colecciones de documentos de tu organización.
`list_document_types`	Lectura	Listar los tipos de documentos disponibles para requisitos de colección.
`list_dossier_documents`	Lectura	Listar los documentos subidos a un expediente.
`list_dossier_notes`	Lectura	Listar las notas / línea de tiempo de auditoría de un expediente.
`list_dossiers`	Lectura	Listar y filtrar expedientes de AutoDoc.
`list_invitation_locales`	Lectura	Listar las configuraciones regionales de invitación compatibles.
`list_invitations`	Lectura	Listar invitaciones de AutoDoc.
`list_organization_tags`	Lectura	Listar las etiquetas de expedientes de tu organización.
`list_workflows`	Lectura	Listar los flujos de trabajo de tu organización.
`reject_approval`	Escritura	Rechazar una aprobación HITL pendiente.
`resend_invitation`	Escritura	Reenviar una invitación de AutoDoc.
`update_document_collection`	Escritura	Actualizar una colección de documentos y (opcionalmente) sus requisitos.
`update_dossier`	Escritura	Renombrar un expediente.
`update_organization_tag`	Escritura	Actualizar el color y/o nombre de una etiqueta de organización.
`update_workflow`	Escritura	Actualizar un flujo de trabajo.

Agentes de Razonamiento y Fraude (25)

Herramienta	Acceso	Descripción
`create_fraud_agent`	Escritura	Crear un agente / operador de análisis de fraude.
`create_orchestrator`	Escritura	Crear un agente orquestador (coordinador).
`create_reasoning_job`	Escritura	Poner en cola un trabajo de razonamiento de fraude ASINCRÓNICO para un documento.
`delete_fraud_agent`	Destructivo	Eliminar un agente / operador de análisis de fraude.
`delete_orchestrator`	Destructivo	Eliminar un agente orquestador.
`generate_fraud_agent_prompt`	Escritura	Redactar un prompt de sistema de agente de análisis de fraude con IA.
`generate_orchestrator_prompt`	Escritura	Redactar un prompt de sistema de orquestador con IA.
`get_agent`	Lectura	Obtener un agente individual (orquestador u operador) por token.
`get_agent_stats`	Lectura	Obtener estadísticas agregadas de agentes para tu organización.
`get_reasoning_job`	Lectura	Obtener el estado y los resultados completos de un trabajo de razonamiento.
`list_agent_categories`	Lectura	Listar las opciones de categoría de agentes disponibles.
`list_agent_ratings`	Lectura	Listar calificaciones y resumen de calificaciones de un agente público.
`list_document_content_types`	Lectura	Listar los tipos de contenido de documentos y cuáles ya están reclamados.
`list_fraud_agents`	Lectura	Listar los agentes / operadores de análisis de fraude de TU organización.
`list_orchestrators`	Lectura	Listar los agentes orquestadores de TU organización.
`list_public_fraud_agents`	Lectura	Explorar plantillas públicas de agentes de análisis de fraude de la comunidad global.
`list_public_orchestrators`	Lectura	Explorar plantillas públicas de orquestadores de la comunidad global.
`list_reasoning_jobs`	Lectura	Listar trabajos de razonamiento con filtros y estadísticas de toda la organización.
`publish_agent`	Escritura	Publicar uno de tus agentes en el mercado público de la comunidad.
`rate_agent`	Escritura	Calificar un agente público con 1-5 estrellas.
`reorder_orchestrator_agents`	Escritura	Reordenar los agentes de análisis de fraude asignados a un orquestador.
`test_orchestrator`	Escritura	Ejecutar un orquestador SINCRÓNICAMENTE contra un documento existente.
`unpublish_agent`	Escritura	Eliminar uno de tus agentes del mercado público.
`update_fraud_agent`	Escritura	Actualizar un agente / operador de análisis de fraude.
`update_orchestrator`	Escritura	Actualizar un agente orquestador.

Facturación (14)

Herramienta	Acceso	Descripción
`cancel_billing_plan`	Destructivo	Programar la cancelación de la suscripción actual.
`change_billing_plan`	Escritura	Cambiar el plan de suscripción de la organización.
`confirm_payment_method`	Escritura	Guardar la tarjeta confirmada como método de pago predeterminado.
`create_setup_intent`	Escritura	Crear un Stripe SetupIntent para recopilar un método de pago.
`download_invoice`	Lectura	Descargar una factura en PDF.
`get_billing_info`	Lectura	Obtener la instantánea completa de facturación de la organización.
`get_current_usage`	Lectura	Obtener el uso no facturado del período de facturación actual.
`get_stripe_config`	Lectura	Obtener la configuración del lado del cliente de Stripe.
`list_billing_plans`	Lectura	Listar todos los planes de suscripción disponibles con precios y funciones.
`list_inference_history`	Lectura	Listar el historial de solicitudes de inferencia / verificación de IA de la organización.
`list_invoices`	Lectura	Listar las facturas de la organización, las más recientes primero.
`topup_balance`	Escritura	Agregar fondos prepagados al saldo de la cuenta mediante la tarjeta guardada.
`update_company_details`	Escritura	Actualizar los datos de empresa / facturación de la organización.
`validate_vat_number`	Lectura	Validar un número de IVA de la UE mediante una consulta externa.

topup_balance está en dólares estadounidenses, mínimo $10, máximo $10,000 por recarga.

Usuarios y Cuenta (7)

Herramienta	Acceso	Descripción
`activate_trial`	Escritura	Guardar un método de pago y activar la prueba gratuita de 7 días con $10 de crédito.
`add_passkey`	Escritura	Comenzar a agregar una clave de acceso a la cuenta del usuario autenticado: obtener opciones de creación de WebAuthn.
`delete_passkey`	Destructivo	Eliminar una de las claves de acceso del usuario autenticado.
`get_current_user`	Lectura	Obtener el usuario autenticado, su organización y estadísticas rápidas de la cuenta.
`list_passkeys`	Lectura	Listar las claves de acceso registradas del usuario autenticado.
`report_public_data`	Escritura	Reportar datos incorrectos en el perfil público del usuario autenticado.
`submit_onboarding_survey`	Escritura	Guardar la encuesta de incorporación de la organización del usuario actual.

Sitios Web (8)

Herramienta	Acceso	Descripción
`create_website`	Escritura	Crear una nueva configuración de sitio web de verificación de edad.
`delete_website`	Destructivo	Eliminar permanentemente una configuración de sitio web de verificación de edad.
`get_website`	Lectura	Obtener un sitio web de verificación de edad por ID.
`list_countries`	Lectura	Listar todos los países con códigos y atributos.
`list_verifications`	Lectura	Explorar el historial de verificación de edad de la organización.
`list_websites`	Lectura	Listar todos los sitios web de verificación de edad de la organización autenticada.
`pause_website`	Escritura	Pausar o reanudar la verificación de edad de un sitio web.
`update_website`	Escritura	Actualizar una configuración existente de sitio web de verificación de edad.

Verificaciones Agemin (3)

Herramienta	Acceso	Descripción
`get_age_verification_status`	Lectura	Revisar un resultado de verificación de edad previo en el servidor.
`verify_age_with_email`	Escritura	Estimar la edad mínima de una persona a partir de su dirección de correo electrónico.
`verify_age_with_selfie`	Escritura	Estimar la edad de una persona a partir de una única selfie.

Sesiones de verificación (16)

Herramienta	Acceso	Descripción
`cancel_session`	Destructivo	Cancelar / abortar una sesión.
`check_email_verification`	Lectura	Completar la verificación de correo electrónico con el código.
`check_phone_verification`	Lectura	Completar la verificación telefónica con el código SMS.
`complete_liveness`	Escritura	Completar una captura de prueba de vida facial.
`create_session`	Escritura	Crear una nueva sesión de verificación de identidad.
`get_session`	Lectura	Mostrar información sobre una sesión abierta.
`get_session_preflight`	Lectura	Obtener el siguiente paso de verificación para una sesión.
`give_session_consent`	Escritura	Registrar la decisión de consentimiento del solicitante.
`send_session_sms`	Escritura	Enviar por SMS al solicitante un enlace para continuar en su teléfono.
`start_email_verification`	Escritura	Iniciar la verificación de correo electrónico enviando un código.
`start_liveness`	Escritura	Iniciar una captura de prueba de vida facial.
`start_phone_verification`	Escritura	Iniciar la verificación telefónica enviando un código por SMS.
`submit_address_verification`	Escritura	Subir un documento de comprobante de domicilio.
`submit_funds_verification`	Escritura	Subir un documento de comprobante de fondos.
`update_session`	Escritura	Actualizar los datos del solicitante de una sesión abierta.
`upload_session_media`	Escritura	Subir medios capturados a una sesión.

Claves API (3)

Herramienta	Acceso	Descripción
`get_api_key`	Lectura	Recuperar el valor COMPLETO y sin enmascarar de una clave API existente.
`list_api_keys`	Lectura	Listar todas las claves API de la organización autenticada.
`rotate_api_key`	Destructivo	Rotar (regenerar) una clave API para la organización autenticada.

list_api_keys devuelve valores enmascarados; solo get_api_key revela el secreto completo, así que mantén la confirmación activada para ello en contextos compartidos. rotate_api_key mantiene la clave anterior válida durante un período de gracia de 12 horas de forma predeterminada; pasa immediate: true para revocarla al instante.

NFC (1)

Herramienta	Acceso	Descripción
`submit_nfc_data`	Escritura	Enviar datos de documentos de identidad escaneados por NFC a una sesión de verificación.

Servidor y autodescubrimiento (2)

Herramienta	Acceso	Descripción
`describe_api`	Lectura	Devolver la especificación OpenAPI 3.0 de la API REST de Bynn (desde /openapi.json).
`describe_cli`	Lectura	Devolver instrucciones de instalación, autenticación y uso para la CLI de Bynn (`bynn`).

Widgets interactivos

Dos familias de herramientas devuelven tarjetas interactivas en lugar de JSON sin procesar en hosts que admiten aplicaciones MCP (ChatGPT y Claude):

Fraude documental (submit_document, get_document): una tarjeta de informe en vivo con el indicador de riesgo, señales forenses, campos extraídos y etiquetas de riesgo. Los análisis pendientes se consultan automáticamente hasta completarse.
Verificación de imagen IA (detect_ai_generated_image): tarjeta de veredicto con probabilidad de IA y un desglose del generador. Si no se proporcionó ninguna imagen, la tarjeta muestra un cargador de arrastrar y soltar, y el archivo soltado va directamente al detector sin entrar en el contexto del chat.

Otros clientes MCP simplemente reciben los mismos datos como JSON estructurado.

Flujo de trabajo de ejemplo

Una sesión KYC completa, impulsada 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

El patrón asíncrono es el mismo en todas partes: las herramientas de creación devuelven un id, las herramientas get_* lo consultan. Para fraude documental, submit_document → get_document hasta status: "analyzed"; para trabajos de razonamiento, create_reasoning_job → get_reasoning_job.

CLI de Bynn: trabajar con archivos locales

El servidor MCP alojado no puede leer archivos en tu máquina. La CLI de Bynn sí puede. Los agentes que se ejecutan localmente (Claude Code, Cursor, una terminal) pueden analizar archivos locales directamente:

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

Instalación (macOS/Linux):

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

Instalación (Windows):

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

Descargas directas (además de .deb/.rpm y sumas de verificación) están en la página de versiones.

Autentícate una vez (bynn auth login almacena la clave en el llavero de tu sistema operativo), o de forma no interactiva con BYNN_API_KEY, --token o bynn auth login --with-token. Las claves de sandbox (private_sandbox_...) se reconocen automáticamente.

Diseñada para agentes: -o json para salida estructurada, --jq para filtrado, --dry-run para previsualizar solicitudes, --poll para resultados asíncronos y un contrato de salida limpio (stdout = datos, stderr = progreso). El árbol de comandos se genera a partir de la especificación OpenAPI en vivo de Bynn, y bynn api <METHOD> <PATH> es un paso directo autenticado sin procesar a cualquier endpoint. La CLI cubre sesiones, verificación de edad, invitaciones de AutoDoc, documentos, moderación, NFC y rostro; para facturación, claves API, expedientes, orquestadores y sitios web, usa este servidor MCP.

Para agentes: llama a la herramienta describe_cli en este servidor para obtener esta guía completa en formato legible por máquina.

Autodescubrimiento para agentes

El servidor se documenta a sí mismo. Si eres un LLM conectado a él:

describe_api devuelve la especificación completa de Bynn OpenAPI 3.0: cada endpoint, parámetro y esquema, incluidos los que no están envueltos como herramientas MCP. No se requiere autenticación.
describe_cli devuelve una guía estructurada para instalar, autenticar y ejecutar la CLI de bynn localmente, para trabajar con archivos locales. No se requiere autenticación.
file://server/status (recurso MCP) devuelve la lista de herramientas en vivo y el estado del servidor.

Estos también se anuncian en las instrucciones de initialize del servidor, por lo que no necesitas este README para encontrarlos.

Avanzado

Anotaciones y contrato de respuesta

Cada herramienta lleva anotaciones MCP ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), aplicadas de manera consistente por verbo: get_*/list_*/ search_*/describe_*/download_*/validate_* son de solo lectura; delete_*/cancel_*/ rotate_api_key son destructivas. Los fallos se devuelven como cargas útiles {error: true, error_type, message} estructuradas en lugar de errores de protocolo, para que los agentes puedan leerlos y reaccionar ante ellos.

Solución de problemas

Síntoma	Solución
404 / la conexión falla inmediatamente	Añadiste `/mcp` a la URL. El endpoint es la raíz: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	Obtén un token en dashboard.bynn.com/authenticate y establécelo como el encabezado `Authorization`. No reintentes a ciegas.
Una herramienta devuelve 401 con una conexión válida	Tipo de credencial incorrecto para ese grupo de herramientas; consulta la tabla de autenticación. Las claves API y la facturación necesitan un token de panel, no una clave `private_` sin procesar.
La herramienta de imagen dice que no se proporcionó ninguna imagen	La tarjeta que aparece acepta arrastrar y soltar; suelta la imagen en ella. O pasa una `image_url` pública.
Documento atascado en `pending`	El análisis es asíncrono; consulta `get_document` hasta que `status` sea `analyzed`. No consultes más de una vez cada pocos segundos.
El conector OAuth deja de funcionar	Desconecta y vuelve a conectar el conector para volver a ejecutar el flujo de inicio de sesión.

Soporte

Problemas y preguntas: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

Licencia MIT.