> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas MCP de Didit: 169 herramientas de identidad

> Todas las herramientas del servidor MCP alojado de Didit por área, con su tipo (lectura/escritura/destructiva), alcance OAuth y permiso de rol.

El servidor alojado en `https://mcp.didit.me/mcp` ofrece a un usuario con sesión iniciada **169 herramientas**: 80 de lectura, 62 de escritura y 27 destructivas.
Las 17 [herramientas del Investigator](#investigator) también aparecen en la lista, pero solo funcionan cuando el Investigator está habilitado para tu organización.
Hay dos más (`didit_org_top_up` y `didit_org_reveal_application_api_key`) que están ocultas en todos los catálogos autenticados con OAuth y solo aparecen en un servidor stdio local, que además añade cinco herramientas de configuración de cuenta (consulta [autoalojamiento](https://docs.didit.me/es/integration/mcp/installation.md#alojamiento-propio)).

Esta página se genera a partir del registro de herramientas de [`didit-protocol/mcp`](https://github.com/didit-protocol/mcp) (`src/index.ts`, la versión que el servidor alojado indica en `serverInfo`). Los nombres, los tipos y los argumentos obligatorios provienen de la propia respuesta `tools/list` del servidor; el permiso de rol proviene de `src/permissions.ts`.

## Cómo leer la tabla

| Columna | Significado |
| - | - |
| **Tipo** | Se obtiene de las anotaciones MCP de la herramienta. **Lectura** es de solo lectura. **Escritura** crea o modifica algo. **Destructiva** elimina o sobrescribe datos, cambia algo que se aplica de inmediato (un workflow publicado, la decisión de una sesión), revela un secreto o mueve dinero; los clientes piden confirmación antes de ejecutarlas. Las verificaciones independientes facturables cuentan como escritura. |
| **Ámbito** | El ámbito OAuth cuyos recursos incluyen el permiso de rol de la herramienta: `didit:verification` para sesiones, empresas, casos, redes, transacciones y la lista de bloqueo; `didit:management` para flujos, cuestionarios, listas, webhooks, integraciones, miembros, roles, claves de API, registros de auditoría, la organización, aplicaciones, suscripción y usuarios. **Cualquiera** indica analítica, que ambos ámbitos incluyen, o una herramienta sin comprobación por rol, que se ejecuta con el ámbito que hayas aprobado. Consulta [Autenticación](https://docs.didit.me/es/integration/mcp/authentication.md#scopes). |
| **Permiso de rol** | El permiso que debe tener el rol de tu organización, tal como lo comprueba el backend de Didit. Un guion indica que el endpoint está limitado por pertenencia o que no tiene comprobación por rol. Si tu rol no tiene el permiso, la herramienta devuelve un error `missing_scope` que lo nombra. |

Todas las herramientas aceptan los parámetros opcionales `organization_id` y `application_id` para fijar un ámbito. Con una sola organización y una sola aplicación, se resuelven automáticamente; con varias, las herramientas `*_search` y `didit_analytics` abarcan todas ellas, y las herramientas `*_list` por aplicación hacen lo mismo cuando no indicas ningún ámbito.

> [!NOTE]
>
> `didit_session_delete` y `didit_session_batch_delete` se niegan a ejecutarse sin `confirm: true` en sus argumentos, igual que las herramientas de decisión del Investigator (`accept`, `override`, `batch_accept`, `rereview`, `question_answer`, `question_dismiss`) y la herramienta disponible solo de forma local `didit_org_reveal_application_api_key`. `didit_case_manage` lo necesita al presentar un SAR, y `didit_vendor_user_delete` y `didit_vendor_business_delete` lo necesitan cuando `delete_all` es true.

***

## Descubrimiento y consultas entre aplicaciones

Estas herramientas abarcan en una sola llamada todas las organizaciones y aplicaciones a las que tienes acceso; cada fila se etiqueta con su organización y su aplicación.

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_context_get` | Lectura | Cualquiera | — | Todas las organizaciones y aplicaciones a las que puedes acceder, anidadas, además de la organización y la aplicación predeterminadas cuando solo hay una. Invócala primero. |
| `didit_session_search` | Lectura | `didit:verification` | `list:sessions` | Busca sesiones de verificación en todas tus aplicaciones y organizaciones, de la más reciente a la más antigua. |
| `didit_transaction_search` | Lectura | `didit:verification` | `list:transactions` | Busca transacciones monitorizadas en todas tus aplicaciones y organizaciones. |
| `didit_case_search` | Lectura | `didit:verification` | `list:cases` | Busca casos de investigación en todas tus aplicaciones y organizaciones. |
| `didit_vendor_user_search` | Lectura | `didit:management` | `list:users` | Encuentra a un cliente final por nombre, correo electrónico o `vendor_data` en todas tus aplicaciones. |
| `didit_vendor_business_search` | Lectura | `didit:verification` | `list:businesses` | Encuentra una empresa de KYB en todas tus aplicaciones. |
| `didit_workflow_search` | Lectura | `didit:management` | `read:workflows` | Encuentra un flujo por id o etiqueta en todas tus aplicaciones; el resultado indica a qué organización y aplicación pertenece. |
| `didit_analytics` | Lectura | Cualquiera | `read:analytics` | Analítica agregada para un intervalo de fechas (desglose de solicitudes, embudo por función, tasa de conversión) en todas tus aplicaciones. |

***

## Sesiones (KYC y KYB)

| Herramienta | Tipo | Alcance | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_session_create` | Escritura | `didit:verification` | `create:sessions` o `write:sessions` | Crea una sesión de verificación para un flujo de verificación. Devuelve `session_id`, `url` y `session_token`. |
| `didit_session_list` | Lectura | `didit:verification` | `list:sessions` | Lista las sesiones de una aplicación. Abarca todas las aplicaciones cuando no indicas un alcance. |
| `didit_session_get_decision` | Lectura | `didit:verification` | `read:sessions` | La decisión completa y todos los datos extraídos de una sesión. |
| `didit_session_get_location_evidence` | Lectura | `didit:verification` | `read:sessions` | Las evidencias de Precise Location de una sesión para cada paso de ubicación: la configuración que la evaluó, el veredicto, cada intento, los puntos de referencia, las distancias y las áreas. |
| `didit_session_update_status` | Destructiva | `didit:verification` | `write:sessions` | Aprueba o rechaza una sesión, o solicita que se vuelva a enviar. |
| `didit_session_update_data` | Escritura | `didit:verification` | `write:sessions` | Corrige los datos extraídos del documento de identidad (corrección del revisor). |
| `didit_session_update_poa_data` | Escritura | `didit:verification` | `write:sessions` | Corrige los datos extraídos del documento de prueba de domicilio. |
| `didit_session_delete` | Destructiva | `didit:verification` | `delete:sessions` | Elimina de forma permanente una sesión junto con sus datos de verificación y sus archivos multimedia. Requiere `confirm: true`. |
| `didit_session_batch_delete` | Destructiva | `didit:verification` | `delete:sessions` | Elimina de forma permanente varias sesiones KYC por número de sesión, o todas las sesiones KYC de la aplicación. Requiere `confirm: true`. Las sesiones KYB nunca se eliminan. |
| `didit_session_generate_pdf` | Escritura | `didit:verification` | `read:sessions` | Genera un informe de verificación en PDF de una sesión. |
| `didit_session_list_reviews` | Lectura | `didit:verification` | `read:sessions` | El historial de revisiones y el registro de actividad de una sesión. |
| `didit_session_add_review` | Escritura | `didit:verification` | `write:sessions` | Añade una nota de revisión a una sesión y, opcionalmente, cambia su estado. |
| `didit_session_share` | Escritura | `didit:verification` | `write:sessions` | Comparte una sesión verificada con un socio de confianza (KYC reutilizable). |
| `didit_session_import_shared` | Escritura | Cualquiera | — | Importa una sesión que un socio compartió contigo (KYC reutilizable). |
| `didit_session_create_import` | Escritura | Cualquiera | — | Inicia un trabajo de importación masiva a partir de un archivo CSV o NDJSON alojado. |
| `didit_session_get_import_template` | Lectura | Cualquiera | — | Descarga la plantilla de importación (encabezados de columna y formato). |
| `didit_session_get_import` | Lectura | Cualquiera | — | Estado y resumen de un trabajo de importación masiva. |
| `didit_session_get_import_errors` | Lectura | Cualquiera | — | Fallos por fila de un trabajo de importación masiva. |
| `didit_session_explain_decision` | Lectura | `didit:verification` | `read:sessions` | Por qué una sesión terminó como Aprobada, Rechazada o En revisión: la función que lo decidió, cada advertencia que tuvo efecto, cada regla de estado que se activó, cualquier corrección del revisor y el ajuste del flujo que hay detrás de cada causa. |
| `didit_session_webhooks` | Lectura | `didit:verification` | `read:sessions` | Las entregas de webhook enviadas para una sesión en los últimos 30 días: destino, estado HTTP, tiempos, encabezados de firma y una copia truncada del payload. |
| `didit_session_webhook_resend` | Escritura | `didit:verification` | `create:sessions` | Reenvía una entrega de webhook registrada de una sesión al endpoint configurado, por ejemplo, después de corregir el endpoint. |

***

## Flujos de verificación

Los flujos simples son una lista plana de funciones; los flujos de grafo añaden ramas, condiciones y pasos de Document AI. Consulta [Avanzado: flujos con ramas](https://docs.didit.me/es/integration/mcp/advanced.md#flujos-con-ramificaciones).

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_workflow_list` | Lectura | `didit:management` | `read:workflows` | Lista los flujos de verificación. Abarca todas las aplicaciones cuando no indicas un ámbito. |
| `didit_workflow_create` | Escritura | `didit:management` | `write:workflows` | Crea un flujo simple y lineal a partir de una lista ordenada de funciones. Lo publica salvo que pases `status: "draft"`. |
| `didit_workflow_get` | Lectura | `didit:management` | `read:workflows` | La configuración completa de un flujo, incluidos los datos que se devuelven por cada función. |
| `didit_workflow_update` | Destructiva | `didit:management` | `write:workflows` | Cambia la configuración de nivel superior de un flujo (etiqueta, indicador de flujo predeterminado, reintentos, expiración, marca blanca, listas de permitidos). |
| `didit_workflow_delete` | Destructiva | `didit:management` | `write:workflows` | Elimina un flujo en borrador. |
| `didit_workflow_get_graph` | Lectura | `didit:management` | `read:workflows` | El grafo de nodos de un flujo con su estado y si se puede editar. Las configuraciones grandes se resumen salvo que las solicites. |
| `didit_workflow_get_field_definitions` | Lectura | `didit:management` | `read:workflows` | Todos los campos sobre los que puedes ramificar y los operadores que acepta cada uno. |
| `didit_workflow_get_feature_config_schema` | Lectura | Cualquiera | — | Todas las claves de `config` que acepta cada función del flujo, con su tipo, límites, valor predeterminado y significado. |
| `didit_workflow_get_id_verification_methods_catalog` | Lectura | `didit:management` | `read:workflows` | Por país, qué consultas sin documento y wallets de identidad digital se ofrecen, si están disponibles y los precios de catálogo de sus consultas. |
| `didit_workflow_get_kyb_registry_catalog` | Lectura | Cualquiera | — | Por país, qué niveles de datos de empresa ofrecen los registros y si se vende la monitorización de registros, con precios. No requiere organización ni aplicación. |
| `didit_workflow_get_branch_fields` | Lectura | `didit:management` | `read:workflows` | Los campos disponibles en un punto de ramificación de un grafo candidato. |
| `didit_workflow_validate_graph` | Lectura | `didit:management` | `read:workflows` | Validación en modo de prueba de un grafo completo. No guarda nada. |
| `didit_workflow_edit_graph` | Destructiva | `didit:management` | `write:workflows` | Modifica un grafo existente con operaciones puntuales; el servidor recupera el grafo completo y guarda un borrador. |
| `didit_workflow_set_graph` | Destructiva | `didit:management` | `write:workflows` | Reemplaza el grafo completo de un flujo. Guarda un borrador; la publicación es un paso aparte. |
| `didit_workflow_create_draft` | Escritura | `didit:management` | `write:workflows` | Crea un borrador editable a partir de un flujo publicado. |
| `didit_workflow_publish` | Destructiva | `didit:management` | `write:workflows` | Publica el borrador pendiente para que las nuevas sesiones lo usen. |
| `didit_workflow_build_graph` | Lectura | `didit:management` | `read:workflows` | Construye un grafo completo a partir de una especificación simple de funciones sin guardar nada. |

***

## Asistente de cumplimiento

Crea un flujo de trabajo a partir de tu perfil regulatorio: una entrevista adaptativa, las obligaciones que te aplican con sus citas y un flujo multipaís generado.

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_compliance_interview_next` | Lectura | `didit:management` | `read:workflows` | La siguiente pregunta de la entrevista de cumplimiento adaptativa, o `done` cuando ha terminado. Pasa todas las respuestas recopiladas hasta el momento en cada llamada. |
| `didit_compliance_profile_get` | Lectura | `didit:management` | `read:workflows` | Tu perfil de cumplimiento guardado: las respuestas de la entrevista y los atributos derivados de ellas. |
| `didit_compliance_profile_set` | Destructiva | `didit:management` | `write:workflows` | Guarda las respuestas de la entrevista completada y reemplaza cualquier perfil de cumplimiento existente. |
| `didit_compliance_requirements` | Lectura | `didit:management` | `read:workflows` | Las obligaciones regulatorias que te aplican, con sus citas, derivadas del perfil guardado. |
| `didit_compliance_generate_workflow` | Lectura | `didit:management` | `read:workflows` | Genera un grafo de flujo de trabajo multipaís a partir del perfil guardado: un tronco común más ramas por país con las comprobaciones que exige cada país. |
| `didit_compliance_check_workflow` | Lectura | `didit:management` | `read:workflows` | Comprueba qué obligaciones cumple o incumple una versión de un flujo de trabajo, con sus citas. |

***

## Cuestionarios

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_questionnaire_list` | Lectura | `didit:management` | `read:questionnaires` | Lista los cuestionarios personalizados de una aplicación. |
| `didit_questionnaire_create` | Escritura | `didit:management` | `write:questionnaires` | Crea un cuestionario a partir de una lista ordenada de preguntas. |
| `didit_questionnaire_append_choices` | Escritura | `didit:management` | `write:questionnaires` | Añade opciones de respuesta a una pregunta de un cuestionario en borrador. |
| `didit_questionnaire_get` | Lectura | `didit:management` | `read:questionnaires` | Las preguntas y opciones de un cuestionario. |
| `didit_questionnaire_update` | Destructiva | `didit:management` | `write:questionnaires` | Actualiza el título, la descripción o las preguntas de un cuestionario. |
| `didit_questionnaire_delete` | Destructiva | `didit:management` | `write:questionnaires` | Elimina un cuestionario. |

***

## APIs de verificación independientes

Llamadas facturables individuales, sin sesión. Todas son un POST que consume créditos, incluso las que parecen una consulta (`kyb_search`, `face_search`).

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_verify_id` | Escritura | `didit:verification` | `create:sessions` | Verifica un documento de identidad a partir de la imagen del anverso (y, opcionalmente, del reverso). |
| `didit_verify_poa` | Escritura | `didit:verification` | `create:sessions` | Verifica un comprobante de domicilio. |
| `didit_verify_database` | Escritura | `didit:verification` | `create:sessions` | Contrasta datos de identidad con fuentes oficiales nacionales y globales. |
| `didit_verify_kyb_search` | Escritura | `didit:verification` | `create:sessions` | Busca en registros de empresas oficiales por nombre o número de registro y devuelve candidatos. |
| `didit_verify_kyb_select` | Escritura | `didit:verification` | `create:sessions` | Obtiene el registro completo de un candidato devuelto por `didit_verify_kyb_search`. |
| `didit_verify_passive_liveness` | Escritura | `didit:verification` | `create:sessions` | Prueba de vida pasiva a partir de una sola imagen. |
| `didit_verify_face_match` | Escritura | `didit:verification` | `create:sessions` | Compara dos imágenes faciales (1:1). |
| `didit_verify_face_search` | Escritura | `didit:verification` | `create:sessions` | Busca un rostro entre rostros verificados previamente (1:N). |
| `didit_verify_age` | Escritura | `didit:verification` | `create:sessions` | Estima la edad de una persona a partir de una imagen facial. |
| `didit_verify_aml` | Escritura | `didit:verification` | `create:sessions` | Analiza un nombre en listas de sanciones, de PEP y de vigilancia y, opcionalmente, en medios adversos. |
| `didit_verify_email_send` | Escritura | Cualquiera | — | Envía un código de un solo uso a una dirección de correo electrónico. |
| `didit_verify_email_check` | Escritura | Cualquiera | — | Comprueba el código enviado a una dirección de correo electrónico. |
| `didit_verify_phone_send` | Escritura | Cualquiera | — | Envía un código de un solo uso a un número de teléfono. |
| `didit_verify_phone_check` | Escritura | Cualquiera | — | Comprueba el código enviado a un número de teléfono. |

***

## Monitorización de transacciones

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_transaction_list` | Lectura | `didit:verification` | `list:transactions` | Lista las transacciones monitorizadas de una aplicación. Abarca todas las aplicaciones si no indicas ningún ámbito. |
| `didit_transaction_create` | Escritura | `didit:verification` | `create:transactions` | Envía una transacción para su monitorización y la evaluación de reglas. |
| `didit_transaction_get` | Lectura | `didit:verification` | `list:transactions` | Una transacción monitorizada con el resultado de la evaluación de reglas. |
| `didit_transaction_screen_wallet` | Escritura | `didit:verification` | `create:transactions` | Analiza el riesgo AML de una dirección de wallet de criptomonedas sin crear una transacción. |
| `didit_transaction_rule_list` | Lectura | `didit:verification` | `list:transactions` | Lista las reglas de monitorización de transacciones de una aplicación. |
| `didit_transaction_rule_get` | Lectura | `didit:verification` | `list:transactions` | Una regla con sus condiciones, agregación, ámbito, acciones y contadores. |
| `didit_transaction_rule_create` | Escritura | `didit:verification` | `write:transactions` | Crea una regla personalizada. |
| `didit_transaction_rule_update` | Escritura | `didit:verification` | `write:transactions` | Actualiza parcialmente una regla. |
| `didit_transaction_rule_delete` | Destructiva | `didit:verification` | `write:transactions` | Elimina una regla personalizada. |
| `didit_transaction_rule_backtest` | Lectura | `didit:verification` | `list:transactions` | Ejecuta en modo de prueba una regla hipotética sobre hasta las 10.000 transacciones más recientes. No realiza ninguna escritura. |
| `didit_transaction_rule_library_list` | Lectura | `didit:verification` | `list:transactions` | Explora la biblioteca de reglas predefinidas de Didit con su estado de instalación. |
| `didit_transaction_rule_install` | Escritura | `didit:verification` | `write:transactions` | Instala reglas predefinidas por clave de biblioteca o por paquete. |
| `didit_transaction_rule_uninstall` | Destructiva | `didit:verification` | `write:transactions` | Quita reglas predefinidas instaladas por clave de biblioteca o por paquete. |
| `didit_transaction_sdk_token` | Escritura | Cualquiera | — | Genera un token de corta duración, vinculado a un usuario final, para enviar transacciones desde los SDK de cliente. |

***

## Travel Rule

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_travel_rule_get_settings` | Lectura | Cualquiera | — | Tu configuración de Travel Rule: perfil de VASP, política de negociación, métodos de prueba, modos por red y tu Travel Address. |
| `didit_travel_rule_update_settings` | Escritura | Cualquiera | — | Cambia la configuración de Travel Rule; envía solo los campos que quieras cambiar. Para activarla se necesita una razón social. |
| `didit_travel_rule_search_vasps` | Lectura | Cualquiera | — | Busca en el directorio de VASP, con las puntuaciones de diligencia debida y las redes a través de las que se puede contactar con cada VASP. |
| `didit_travel_rule_list_wallet_addresses` | Lectura | Cualquiera | — | La libreta de direcciones de wallets con la que se cotejan las transferencias entrantes, con el estado de verificación de propiedad de cada dirección. |
| `didit_travel_rule_add_wallet_address` | Escritura | Cualquiera | — | Añade a la libreta de direcciones una wallet que controlas, opcionalmente con la propiedad ya verificada por autodeclaración. |
| `didit_travel_rule_update_wallet_address` | Escritura | Cualquiera | — | Actualiza los datos del titular de una entrada de la libreta de direcciones. |
| `didit_travel_rule_delete_wallet_address` | Destructiva | Cualquiera | — | Elimina una entrada de la libreta de direcciones; deja de aplicarse a nuevas transferencias de inmediato. |
| `didit_travel_rule_confirm_ownership` | Destructiva | Cualquiera | — | Confirma o niega la propiedad de la wallet en una transferencia que está a la espera de una prueba de propiedad. |
| `didit_travel_rule_transfer_action` | Destructiva | Cualquiera | — | Finaliza una transferencia saliente con su hash on-chain, cancela una transferencia que no es definitiva o vuelve a ejecutar el enrutamiento hacia la contraparte. |
| `didit_travel_rule_get_vasp` | Lectura | Cualquiera | — | Obtiene una entrada del directorio de VASP por id, con los mismos campos que una fila de búsqueda: rutas, listados de redes, alias, contactos y entidades. |
| `didit_travel_rule_list_networks` | Lectura | Cualquiera | — | El estado de cada red de Travel Rule para tu aplicación, con el motivo, tu registro de participante y el cuestionario de diligencia debida. |
| `didit_travel_rule_request_network` | Escritura | Cualquiera | — | Solicita unirte a una red de Travel Rule como participante. La solicitud queda en espera hasta que se apruebe el cuestionario de diligencia debida. |
| `didit_travel_rule_get_network_questionnaire` | Lectura | Cualquiera | — | El cuestionario de diligencia debida para el acceso a la red: estado, respuestas guardadas, la nota del revisor y el historial de estados. |
| `didit_travel_rule_update_network_questionnaire` | Escritura | Cualquiera | — | Guarda respuestas en el borrador del cuestionario. Envía solo las respuestas que quieras cambiar. |
| `didit_travel_rule_submit_network_questionnaire` | Destructiva | Cualquiera | — | Envía a revisión el cuestionario guardado. No se puede editar mientras está en revisión. |
| `didit_travel_rule_set_counterparty_vasp` | Escritura | Cualquiera | — | Elige el VASP de contraparte de una transferencia saliente que no se pudo enrutar y vuelve a ejecutar el intercambio hacia él. |
| `didit_travel_rule_list_messages` | Lectura | Cualquiera | — | Los mensajes y solicitudes de documentos intercambiados con el VASP de contraparte en una transferencia, del más antiguo al más reciente. |
| `didit_travel_rule_send_message` | Escritura | Cualquiera | — | Envía un mensaje o una solicitud de documentos al VASP de contraparte de una transferencia. Solo las transferencias con otro cliente de Didit o por correo electrónico admiten mensajes. |
| `didit_travel_rule_list_counterparty_contacts` | Lectura | Cualquiera | — | Los contactos de cumplimiento que se usan para contactar por correo electrónico con un VASP de contraparte: los de la plataforma y los propios de tu aplicación. |
| `didit_travel_rule_add_counterparty_contact` | Escritura | Cualquiera | — | Añade un contacto de cumplimiento para un VASP del directorio, exclusivo de tu aplicación. |
| `didit_travel_rule_delete_counterparty_contact` | Destructiva | Cualquiera | — | Elimina uno de los contactos de contraparte propios de tu aplicación. |
| `didit_travel_rule_get_sandbox_scenarios` | Lectura | Cualquiera | — | El Didit Test VASP con el que intercambian las aplicaciones de sandbox y los escenarios (aceptación, rechazo, nombre no coincidente, no accesible, tiempo de espera agotado, wallet sin custodia) que selecciona cada dirección de wallet. |
| `didit_travel_rule_trigger_test_inbound` | Escritura | Cualquiera | — | Solo para aplicaciones de sandbox: hace que el Didit Test VASP te envíe una transferencia entrante de Travel Rule. |

***

## Usuarios y empresas del proveedor

| Herramienta | Tipo | Ámbito | Permiso de rol | Qué hace |
| - | - | - | - | - |
| `didit_vendor_user_list` | Lectura | `didit:management` | `list:users` | Lista los usuarios verificados agrupados por `vendor_data`. Abarca todas las aplicaciones si no indicas un ámbito. |
| `didit_vendor_user_create` | Escritura | `didit:management` | `create:users` | Crea manualmente un registro de usuario. |
| `didit_vendor_user_get` | Lectura | `didit:management` | `read:users` | Un usuario por `vendor_data`. |
| `didit_vendor_user_update` | Escritura | `didit:management` | `write:users` | Actualiza los campos del perfil de un usuario. |
| `didit_vendor_user_update_status` | Escritura | `didit:management` | `write:users` | Establece el estado de un usuario en `ACTIVE`, `FLAGGED` o `BLOCKED`. |
| `didit_vendor_user_delete` | Destructiva | `didit:management` | `delete:users` | Elimina usuarios en lote por `vendor_data` o elimina todos los usuarios. |
| `didit_vendor_business_list` | Lectura | `didit:verification` | `list:businesses` | Lista las empresas verificadas agrupadas por `vendor_data`. Abarca todas las aplicaciones si no indicas un ámbito. |
| `didit_vendor_business_create` | Escritura | `didit:verification` | `create:businesses` | Crea manualmente un registro de empresa. |
| `didit_vendor_business_get` | Lectura | `didit:verification` | `read:businesses` | Una empresa por `vendor_data`. |
| `didit_vendor_business_update` | Escritura | Cualquiera | — | Actualiza los campos del perfil de una empresa. |
| `didit_vendor_business_update_status` | Escritura | `didit:verification` | `write:businesses` | Establece el estado de una empresa en `ACTIVE`, `FLAGGED` o `BLOCKED`. |
| `didit_vendor_business_delete` | Destructiva | `didit:verification` | `delete:businesses` | Elimina empresas en lote por `vendor_data` o por id interno, o elimina todas las empresas. |

***

## Listas, lista de bloqueo y lista de permitidos

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_lists_list` | Lectura | `didit:management` | `read:lists` | Todas las listas de una aplicación: listas de bloqueo, listas de permitidos y listas personalizadas. |
| `didit_lists_create` | Escritura | `didit:management` | `create:lists` | Crea una lista de permitidos o una lista personalizada. |
| `didit_lists_get` | Lectura | `didit:management` | `read:lists` | Una lista por su UUID. |
| `didit_lists_update` | Escritura | `didit:management` | `write:lists` | Cambia el nombre de una lista o su descripción. |
| `didit_lists_delete` | Destructiva | `didit:management` | `delete:lists` | Elimina una lista y todas sus entradas. |
| `didit_lists_entries_list` | Lectura | `didit:management` | `read:lists` | Las entradas de una lista. |
| `didit_lists_entry_create` | Escritura | `didit:management` | `create:lists` | Añade una entrada a una lista, mediante un valor o a partir de una sesión. |
| `didit_lists_entry_upload_face` | Escritura | `didit:management` | `create:lists` | Añade un rostro a una lista de rostros a partir de una imagen, sin sesión. |
| `didit_lists_entry_delete` | Destructiva | `didit:management` | `delete:lists` | Quita una entrada de una lista. |
| `didit_blocklist_get` | Lectura | `didit:verification` | `read:blocklist` | Lista las entradas de la lista de bloqueo (función auxiliar heredada). |
| `didit_blocklist_add` | Escritura | `didit:verification` | `write:blocklist` | Añade una entrada a la lista de bloqueo (función auxiliar heredada). |
| `didit_blocklist_remove` | Destructiva | `didit:verification` | `write:blocklist` | Quita una entrada de la lista de bloqueo (función auxiliar heredada). |
| `didit_allowlist_add` | Escritura | `didit:verification` | `write:blocklist` | Añade una entrada a la lista de permitidos (función auxiliar heredada). |

***

## Casos

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_case_list` | Lectura | `didit:verification` | `list:cases` | Lista los casos de una aplicación. Abarca todas las aplicaciones si no indicas un ámbito. |
| `didit_case_get` | Lectura | `didit:verification` | `read:cases` | Un caso con sus detalles. |
| `didit_case_create` | Escritura | `didit:verification` | `write:cases` | Abre un caso. |
| `didit_case_statistics` | Lectura | `didit:verification` | `list:cases` | Recuento de casos por estado y estadísticas similares. |
| `didit_case_manage` | Destructiva | `didit:verification` | `write:cases` | Asigna, resuelve, reabre, escala, comenta o actualiza un caso. |

***

## Redes de fraude

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_network_list` | Lectura | `didit:verification` | `list:networks` | Lista las redes de fraude de una aplicación, con los filtros y los KPI de la consola. |
| `didit_network_get` | Lectura | `didit:verification` | `read:networks` | Una red de fraude con sus miembros y señales; grafo, mapa y cronología si se solicitan. |
| `didit_network_membership_get` | Lectura | `didit:verification` | `read:networks` | Las redes de fraude a las que pertenece una sesión, una sesión de empresa, un usuario, una empresa o una transacción. |

***

## Investigator

Estas herramientas aparecen en `tools/list` para todo usuario que haya iniciado sesión, pero solo funcionan una vez que el [Investigator](https://docs.didit.me/es/console/investigator.md) está habilitado para tu organización.

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_investigator_queue_list` | Lectura | Cualquiera | — | Lista los informes abiertos del Investigator, es decir, la cola de revisión, con la recomendación y el nivel de confianza de cada uno. |
| `didit_investigator_report_get` | Lectura | Cualquiera | — | Un informe del Investigator: recomendación, confianza, riesgo, narrativa, evidencias, precedentes y preguntas. |
| `didit_investigator_record_get` | Lectura | Cualquiera | — | La revisión más reciente del Investigator sobre una verificación o una transacción, abierta o ya decidida. |
| `didit_investigator_accept` | Destructiva | Cualquiera | — | Acepta la recomendación del Investigator sobre un elemento; el elemento queda decidido y registrado a tu nombre. |
| `didit_investigator_override` | Destructiva | Cualquiera | — | Decide un elemento con otra acción, una categoría y un motivo en lugar de la recomendación. |
| `didit_investigator_batch_accept` | Destructiva | Cualquiera | — | Acepta hasta 50 recomendaciones listas a la vez; un elemento que no se puede aceptar se omite indicando el motivo. |
| `didit_investigator_add_note` | Escritura | Cualquiera | — | Añade un dato sobre el elemento de un informe como nota del equipo que se leerá en la siguiente revisión. |
| `didit_investigator_rereview` | Destructiva | Cualquiera | — | Pide al Investigator que vuelva a revisar un elemento; el nuevo informe sustituye al abierto. |
| `didit_investigator_question_list` | Lectura | Cualquiera | — | Las preguntas de política que plantea el Investigator, de la más reciente a la más antigua. |
| `didit_investigator_question_get` | Lectura | Cualquiera | — | Una pregunta de política con lo que hizo el equipo en esa situación durante los últimos 30 días y las respuestas posibles. |
| `didit_investigator_question_answer` | Destructiva | Cualquiera | — | Responde a una pregunta de política; la mayoría de las respuestas crean una nueva versión de la política. |
| `didit_investigator_question_dismiss` | Destructiva | Cualquiera | — | Cierra una pregunta de política sin responderla. |
| `didit_investigator_backtest_start` | Escritura | Cualquiera | — | Inicia un backtest gratuito que vuelve a aplicar la política actual a las decisiones de los últimos 30 o 90 días. No decide nada. |
| `didit_investigator_backtest_get` | Lectura | Cualquiera | — | Un backtest guardado: coincidencia por cola, nivel y umbral. |
| `didit_investigator_performance_get` | Lectura | Cualquiera | — | La coincidencia del Investigator con tu equipo, el volumen, el tiempo ahorrado y las anulaciones en 7, 30 o 90 días. |
| `didit_investigator_dashboard_get` | Lectura | Cualquiera | — | El panel del Investigator: automatización de 30 días, historial semanal, gasto y anulaciones. |
| `didit_investigator_activity_list` | Lectura | Cualquiera | — | El registro de actividad del Investigator, de lo más reciente a lo más antiguo: lo que hicieron el agente y las personas. |

***

## Informes, registro de auditoría y alertas

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_report_list` | Lectura | Cualquiera | — | Lista los informes de exportación. |
| `didit_report_get` | Lectura | Cualquiera | — | Estado y detalles de un informe de exportación. |
| `didit_report_get_download_url` | Lectura | Cualquiera | — | Una URL de descarga firmada para un informe terminado. |
| `didit_report_export` | Escritura | Cualquiera | — | Inicia una exportación (sesiones, transacciones, usuarios o empresas). |
| `didit_audit_log_list` | Lectura | Cualquiera | — | Entradas del registro de auditoría de una aplicación: quién cambió qué. |
| `didit_alert_list` | Lectura | `didit:management` | `read:applications` | Las alertas configuradas de una aplicación. |
| `didit_alert_configure` | Escritura | `didit:management` | `write:applications` | Configura una alerta por tipo. |

***

## Webhooks

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_webhook_list` | Lectura | `didit:management` | `read:webhooks` | Los destinos de webhook de una aplicación. |
| `didit_webhook_create` | Escritura | `didit:management` | `write:webhooks` | Crea un destino de webhook. El secreto de firma aparece oculto en la respuesta; cópialo desde la consola. |
| `didit_webhook_get` | Lectura | `didit:management` | `read:webhooks` | Un destino de webhook, con el secreto de firma oculto. |
| `didit_webhook_update` | Destructiva | `didit:management` | `write:webhooks` | Cambia la URL, la versión, el indicador de activación o los eventos suscritos de un destino. |
| `didit_webhook_delete` | Destructiva | `didit:management` | `write:webhooks` | Elimina un destino de webhook. |

***

## Marketplace

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_marketplace_list_catalog` | Lectura | `didit:management` | `read:integrations` | El marketplace de proveedores: análisis de blockchain, análisis AML, proveedores de verificación telefónica y bancaria, y redes de Travel Rule, con las credenciales que necesita cada uno. |
| `didit_marketplace_list_connections` | Lectura | `didit:management` | `read:integrations` | Las conexiones del marketplace y las membresías de red de tu aplicación, con su estado y último uso. Los secretos nunca se devuelven. |
| `didit_marketplace_request_integration` | Escritura | `didit:management` | `write:integrations` | Solicita una integración que todavía no es de autoservicio; el equipo de Didit hará el seguimiento. |

***

## Organización, miembros, facturación y marca

Dos herramientas de este grupo (`didit_org_top_up`, `didit_org_reveal_application_api_key`) están definidas en el servidor, pero ocultas en el catálogo de cualquier cliente autenticado mediante OAuth; solo se listan en un servidor stdio local.

| Herramienta | Tipo | Alcance | Permiso del rol | Qué hace |
| - | - | - | - | - |
| `didit_org_list` | Lectura | Cualquiera | — | Las organizaciones a las que perteneces. |
| `didit_org_list_applications` | Lectura | Cualquiera | — | Las aplicaciones de una organización. |
| `didit_org_get_application` | Lectura | Cualquiera | — | Detalles de la aplicación, con la clave de API oculta. |
| `didit_org_reveal_application_api_key` | Destructiva | Cualquiera | — | Devuelve la clave de API de la aplicación sin ocultar. Requiere ID explícitos y `confirm: true`. Oculta en el conector alojado. |
| `didit_org_get_balance` | Lectura | `didit:management` | `read:subscription` | Saldo de créditos y configuración de recarga automática. |
| `didit_org_top_up` | Destructiva | Cualquiera | — | Crea un checkout de Stripe para añadir créditos. Oculta en el conector alojado. |
| `didit_branding_get` | Lectura | `didit:management` | `read:customization` | La marca (logotipos, colores) aplicada a tu interfaz de verificación. |
| `didit_branding_update` | Escritura | `didit:management` | `write:customization` | Sube nuevas imágenes de marca. |
| `didit_org_list_members` | Lectura | `didit:management` | `list:members` | Los miembros de una organización. |
| `didit_org_invite_member` | Escritura | `didit:management` | `write:members` | Invita a un miembro por correo electrónico con un rol. |
| `didit_org_update_member` | Escritura | `didit:management` | `write:members` | Cambia el rol de un miembro. |
| `didit_org_remove_member` | Destructiva | `didit:management` | `delete:members` | Elimina a un miembro de la organización. |
| `didit_org_list_roles` | Lectura | `didit:management` | `list:roles` | Los roles disponibles en la organización. |
| `didit_org_list_api_keys` | Lectura | `didit:management` | `read:applications` | Metadatos de las claves de API, con los valores de las claves ocultos. |

***

## Entradas de archivo

Las herramientas que reciben un archivo (`didit_verify_id`, `didit_verify_poa`, `didit_verify_passive_liveness`, `didit_verify_face_match`, `didit_verify_face_search`, `didit_verify_age`, `didit_lists_entry_upload_face`, `didit_branding_update`) lo aceptan de una de dos formas:

* `*_base64`: el contenido del archivo en línea, como base64 sin procesar o como URL `data:`. Usa esta forma con el endpoint alojado.
* `*_path`: una ruta absoluta en la máquina que ejecuta el servidor. Solo funciona con un servidor stdio local que comparte el sistema de archivos contigo.

Ambas formas aplican un límite de 15 MB y una lista de permitidos de bytes mágicos (PNG, JPG, WebP, GIF, BMP, ICO, PDF). El transporte alojado acepta cuerpos JSON de hasta 25 MB.

***

> [card] [Ejemplos](https://docs.didit.me/es/integration/mcp/examples.md)
>
> Conversaciones que usan estas herramientas de principio a fin.

> [card] [Avanzado](https://docs.didit.me/es/integration/mcp/advanced.md)
>
> Roles, comportamiento entre aplicaciones, flujos con ramificaciones, webhooks, autoalojamiento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.