> ## 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.

# Eines MCP de Didit: referència de 169 eines d'identitat

> Totes les eines del servidor MCP allotjat de Didit, per àrea, amb el tipus lectura/escriptura/destructiva, l'àmbit OAuth i el permís de rol.

El servidor allotjat a `https://mcp.didit.me/mcp` ofereix a un usuari amb sessió iniciada **169 eines**: 80 de lectura, 62 d'escriptura i 27 destructives.
Les 17 [eines de l'Investigator](#investigator) també apareixen, però només funcionen quan l'Investigator està habilitat per a la teva organització.
Hi ha dues eines més (`didit_org_top_up` i `didit_org_reveal_application_api_key`) que queden ocultes de tots els catàlegs autenticats amb OAuth i només apareixen en un servidor stdio local, que també afegeix cinc eines de configuració del compte (consulta [l'autoallotjament](https://docs.didit.me/ca/integration/mcp/installation.md#autoallotjament)).

Aquesta pàgina es genera a partir del registre d'eines de [`didit-protocol/mcp`](https://github.com/didit-protocol/mcp) (`src/index.ts`, la versió que informa el servidor allotjat a `serverInfo`). Els noms, els tipus i els arguments obligatoris provenen de la resposta `tools/list` del propi servidor; el permís de rol prové de `src/permissions.ts`.

## Com llegir la taula

| Columna | Significat |
| - | - |
| **Tipus** | Ve de les anotacions MCP de l'eina. **Lectura** només llegeix. **Escriptura** crea o modifica alguna cosa. **Destructiu** elimina o sobreescriu dades, modifica alguna cosa que té efecte immediat (un flux publicat, una decisió de sessió), revela un secret o mou diners; els clients demanen confirmació abans d'executar-les. Les comprovacions independents facturables compten com a escriptures. |
| **Àmbit** | L'àmbit OAuth els recursos del qual inclouen el permís de rol de l'eina: `didit:verification` per a sessions, empreses, casos, xarxes, transaccions i la llista de bloqueig; `didit:management` per a fluxos, qüestionaris, llistes, webhooks, integracions, membres, rols, claus d'API, registres d'auditoria, l'organització, aplicacions, subscripció i usuaris. **Qualsevol dels dos** vol dir analítica, que tots dos àmbits inclouen, o una eina sense comprovació per rol, que s'executa amb l'àmbit que hagis aprovat. Consulta [Autenticació](https://docs.didit.me/ca/integration/mcp/authentication.md#àmbits). |
| **Permís del rol** | El permís que ha de tenir el rol de la teva organització, tal com el comprova el backend de Didit. Un guió indica que l'endpoint està limitat a la membresia o no té comprovació per rol. Quan el teu rol no té el permís, l'eina retorna un error `missing_scope` que n'indica el nom. |

Totes les eines accepten `organization_id` i `application_id` opcionals per fixar un àmbit. Amb una sola organització i una sola aplicació es resolen automàticament; amb diverses, les eines `*_search` i `didit_analytics` les abasten totes, i les eines `*_list` per aplicació fan el mateix quan no passes cap àmbit.

> [!NOTE]
>
> `didit_session_delete` i `didit_session_batch_delete` es neguen a executar-se sense `confirm: true` als seus arguments, igual que les eines de decisió de l'Investigator (`accept`, `override`, `batch_accept`, `rereview`, `question_answer`, `question_dismiss`) i l'eina només local `didit_org_reveal_application_api_key`. `didit_case_manage` la necessita quan presenta un SAR, i `didit_vendor_user_delete` i `didit_vendor_business_delete` la necessiten quan `delete_all` és true.

***

## Descobriment i aplicacions entre aplicacions

Aquestes eines abasten totes les organitzacions i aplicacions a les quals pots accedir en una sola crida; cada fila s'etiqueta amb la seva organització i aplicació.

| Eina | Tipus | Àmbit | Permís del rol | Què fa |
| - | - | - | - | - |
| `didit_context_get` | Lectura | Qualsevol | — | Totes les organitzacions i aplicacions a les quals pots accedir, anidades, més l'organització i l'aplicació per defecte quan només n'hi ha una. Crida-la primer. |
| `didit_session_search` | Lectura | `didit:verification` | `list:sessions` | Cerca sessions de verificació a totes les teves aplicacions i organitzacions, primer les més recents. |
| `didit_transaction_search` | Lectura | `didit:verification` | `list:transactions` | Cerca transaccions monitoritzades a totes les teves aplicacions i organitzacions. |
| `didit_case_search` | Lectura | `didit:verification` | `list:cases` | Cerca casos d'investigació a totes les teves aplicacions i organitzacions. |
| `didit_vendor_user_search` | Lectura | `didit:management` | `list:users` | Troba un client final pel nom, el correu electrònic o `vendor_data` a totes les teves aplicacions. |
| `didit_vendor_business_search` | Lectura | `didit:verification` | `list:businesses` | Troba una empresa KYB a totes les teves aplicacions. |
| `didit_workflow_search` | Lectura | `didit:management` | `read:workflows` | Troba un flux per id o etiqueta a totes les teves aplicacions; el resultat indica quina organització i aplicació el posseeixen. |
| `didit_analytics` | Lectura | Qualsevol | `read:analytics` | Analítica agregada per a una finestra de dates (desglossament de sol·licituds, embut de funcionalitats, taxa de conversió) a totes les teves aplicacions. |

***

## Sessions (KYC i KYB)

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_session_create` | Escriptura | `didit:verification` | `create:sessions` o `write:sessions` | Crea una sessió de verificació per a un flux de treball. Retorna `session_id`, `url` i `session_token`. |
| `didit_session_list` | Lectura | `didit:verification` | `list:sessions` | Llista les sessions d'una aplicació. Si no indiques cap àmbit, abasta totes les aplicacions. |
| `didit_session_get_decision` | Lectura | `didit:verification` | `read:sessions` | La decisió completa i totes les dades extretes d'una sessió. |
| `didit_session_get_location_evidence` | Lectura | `didit:verification` | `read:sessions` | L'evidència de Precise Location d'una sessió per a cada pas de ubicació: la configuració que l'ha avaluat, el veredicte, cada intent, els punts de referència, les distàncies i les àrees. |
| `didit_session_update_status` | Destructiva | `didit:verification` | `write:sessions` | Aprova, rebutja o sol·licita una nova presentació d'una sessió. |
| `didit_session_update_data` | Escriptura | `didit:verification` | `write:sessions` | Corregeix les dades extretes del document d'identitat (substitució pel revisor). |
| `didit_session_update_poa_data` | Escriptura | `didit:verification` | `write:sessions` | Corregeix les dades extretes del comprovant de domicili. |
| `didit_session_delete` | Destructiva | `didit:verification` | `delete:sessions` | Elimina de manera permanent una sessió amb les seves dades de verificació i fitxers multimèdia. Requereix `confirm: true`. |
| `didit_session_batch_delete` | Destructiva | `didit:verification` | `delete:sessions` | Elimina de manera permanent moltes sessions KYC pel seu número de sessió, o totes les sessions KYC de l'aplicació. Requereix `confirm: true`. Les sessions KYB mai no es toquen. |
| `didit_session_generate_pdf` | Escriptura | `didit:verification` | `read:sessions` | Genera un informe de verificació en PDF per a una sessió. |
| `didit_session_list_reviews` | Lectura | `didit:verification` | `read:sessions` | L'historial de revisions i el registre d'activitat d'una sessió. |
| `didit_session_add_review` | Escriptura | `didit:verification` | `write:sessions` | Afegeix una nota de revisió a una sessió, i opcionalment canvia el seu estat. |
| `didit_session_share` | Escriptura | `didit:verification` | `write:sessions` | Comparteix una sessió verificada amb un soci de confiança (KYC reutilitzable). |
| `didit_session_import_shared` | Escriptura | Qualsevol | — | Importa una sessió que un soci t'ha compartit (KYC reutilitzable). |
| `didit_session_create_import` | Escriptura | Qualsevol | — | Inicia una tasca d'importació massiva a partir d'un fitxer CSV o NDJSON allotjat. |
| `didit_session_get_import_template` | Lectura | Qualsevol | — | Descarrega la plantilla d'importació (encapçalaments de columna i format). |
| `didit_session_get_import` | Lectura | Qualsevol | — | Estat i resum d'una tasca d'importació massiva. |
| `didit_session_get_import_errors` | Lectura | Qualsevol | — | Errors per fila d'una tasca d'importació massiva. |
| `didit_session_explain_decision` | Lectura | `didit:verification` | `read:sessions` | Per què una sessió ha acabat com a aprovada, rebutjada o en revisió: la funcionalitat decisiva, cada advertència que ha tingut efecte, cada regla d'estat activada, qualsevol modificació feta pel revisor i la configuració del flux de treball darrere de cada causa. |
| `didit_session_webhooks` | Lectura | `didit:verification` | `read:sessions` | Els lliuraments de webhook enviats per a una sessió en els darrers 30 dies: destinació, estat HTTP, els temps de lliurament, capçaleres de signatura i una còpia limitada del payload. |
| `didit_session_webhook_resend` | Escriptura | `didit:verification` | `create:sessions` | Torna a enviar un lliurament de webhook registrat d'una sessió a l'endpoint configurat, per exemple després d'haver corregit l'endpoint. |

***

## Fluxos de treball

Els fluxos de treball simples són una llista plana de funcionalitats; els fluxos de treball amb graf afegeixen branques, condicions i passos de Document AI. Consulta [Avançat: fluxos de treball amb branques](https://docs.didit.me/ca/integration/mcp/advanced.md#branques-de-flux-de-treball).

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_workflow_list` | Lectura | `didit:management` | `read:workflows` | Llista els fluxos de treball de verificació. Abasta totes les aplicacions si no indiques cap àmbit. |
| `didit_workflow_create` | Escriptura | `didit:management` | `write:workflows` | Crea un flux de treball simple i lineal a partir d'una llista ordenada de funcionalitats. El publica tret que passis `status: "draft"`. |
| `didit_workflow_get` | Lectura | `didit:management` | `read:workflows` | La configuració completa d'un flux de treball, incloent els punts de dades que es retornen per cada funcionalitat. |
| `didit_workflow_update` | Destructiva | `didit:management` | `write:workflows` | Canvia la configuració de nivell superior d'un flux de treball (etiqueta, marca per defecte, reintents, caducitat, marca blanca, llistes d'elements permesos). |
| `didit_workflow_delete` | Destructiva | `didit:management` | `write:workflows` | Elimina un flux de treball en esborrany. |
| `didit_workflow_get_graph` | Lectura | `didit:management` | `read:workflows` | El graf de nodes d'un flux de treball amb el seu estat i si es pot editar. Les configuracions grans es resumeixen tret que les demanis. |
| `didit_workflow_get_field_definitions` | Lectura | `didit:management` | `read:workflows` | Tots els camps en què pots basar les branques i els operadors que accepta cadascun. |
| `didit_workflow_get_feature_config_schema` | Lectura | Qualsevol | — | Totes les claus de `config` que accepta cada funcionalitat del flux de treball, amb tipus, límits, valor per defecte i significat. |
| `didit_workflow_get_id_verification_methods_catalog` | Lectura | `didit:management` | `read:workflows` | Per país, quines consultes que no es basen en documents i quines carteres d'identitat digital s'ofereixen, si estan actives i els preus del catàleg de consultes. |
| `didit_workflow_get_kyb_registry_catalog` | Lectura | Qualsevol | — | Per país, quins nivells de dades d'empresa ofereixen els registres i si es ven la monitorització de registres, amb preus. No cal cap organització ni aplicació. |
| `didit_workflow_get_branch_fields` | Lectura | `didit:management` | `read:workflows` | Els camps disponibles en un punt de branca concret d'un graf candidat. |
| `didit_workflow_validate_graph` | Lectura | `didit:management` | `read:workflows` | Validació en mode de prova d'un graf complet. No desa res. |
| `didit_workflow_edit_graph` | Destructiva | `didit:management` | `write:workflows` | Modifica un graf existent amb operacions menors; el servidor obté el graf complet i desa un esborrany. |
| `didit_workflow_set_graph` | Destructiva | `didit:management` | `write:workflows` | Substitueix tot el graf d'un flux de treball. Desa un esborrany; publicar és un pas separat. |
| `didit_workflow_create_draft` | Escriptura | `didit:management` | `write:workflows` | Crea un esborrany editable a partir d'un flux de treball publicat. |
| `didit_workflow_publish` | Destructiva | `didit:management` | `write:workflows` | Publica l'esborrany pendent perquè les noves sessions l'utilitzin. |
| `didit_workflow_build_graph` | Lectura | `didit:management` | `read:workflows` | Construeix un graf complet a partir d'una especificació simple de funcionalitats sense desar res. |

***

## Assistent de compliment

Crea un flux de treball a partir del teu perfil regulatori: una entrevista adaptativa, les obligacions que t'apliquen amb citacions i un flux de treball multipaís generat.

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_compliance_interview_next` | Lectura | `didit:management` | `read:workflows` | La següent pregunta de l'entrevista adaptativa de compliment, o `done` quan l'entrevista s'ha completat. Passa totes les respostes recollides fins ara en cada crida. |
| `didit_compliance_profile_get` | Lectura | `didit:management` | `read:workflows` | El teu perfil de compliment desat: les respostes de l'entrevista i els atributs que se'n deriven. |
| `didit_compliance_profile_set` | Destructiva | `didit:management` | `write:workflows` | Desa les respostes de l'entrevista completada, substituint qualsevol perfil de compliment existent. |
| `didit_compliance_requirements` | Lectura | `didit:management` | `read:workflows` | Les obligacions regulatòries que t'apliquen, amb citacions, derivades del perfil desat. |
| `didit_compliance_generate_workflow` | Lectura | `didit:management` | `read:workflows` | Genera un graf de flux de treball multipaís a partir del perfil desat: un tronc comú més branques per país amb les verificacions que cada país exigeix. |
| `didit_compliance_check_workflow` | Lectura | `didit:management` | `read:workflows` | Comprova quines obligacions compleix o incompleix una versió del flux de treball, amb citacions. |

***

## Qüestionaris

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_questionnaire_list` | Lectura | `didit:management` | `read:questionnaires` | Llista els qüestionaris personalitzats d'una aplicació. |
| `didit_questionnaire_create` | Escriptura | `didit:management` | `write:questionnaires` | Crea un qüestionari a partir d'una llista ordenada de preguntes. |
| `didit_questionnaire_append_choices` | Escriptura | `didit:management` | `write:questionnaires` | Afegeix opcions de resposta a una pregunta d'un qüestionari en esborrany. |
| `didit_questionnaire_get` | Lectura | `didit:management` | `read:questionnaires` | Les preguntes i les opcions d'un qüestionari concret. |
| `didit_questionnaire_update` | Destructiva | `didit:management` | `write:questionnaires` | Actualitza el títol, la descripció o les preguntes d'un qüestionari. |
| `didit_questionnaire_delete` | Destructiva | `didit:management` | `write:questionnaires` | Elimina un qüestionari. |

***

## APIs de verificació independents

Crides facturables individuals sense sessió. Totes són peticions POST que consumeixen crèdits, fins i tot les que semblen una consulta (`kyb_search`, `face_search`).

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_verify_id` | Escriptura | `didit:verification` | `create:sessions` | Verifica un document d'identitat a partir de la imatge del davant (i, opcionalment, del darrere). |
| `didit_verify_poa` | Escriptura | `didit:verification` | `create:sessions` | Verifica un comprovant de domicili. |
| `didit_verify_database` | Escriptura | `didit:verification` | `create:sessions` | Comprova les dades d'identitat amb fonts nacionals i mundials autoritzades. |
| `didit_verify_kyb_search` | Escriptura | `didit:verification` | `create:sessions` | Cerca als registres mercantils oficials pel nom o el número de registre; retorna candidats. |
| `didit_verify_kyb_select` | Escriptura | `didit:verification` | `create:sessions` | Obté el registre mercantil complet d'un candidat retornat per `didit_verify_kyb_search`. |
| `didit_verify_passive_liveness` | Escriptura | `didit:verification` | `create:sessions` | Prova de vida passiva a partir d'una sola imatge. |
| `didit_verify_face_match` | Escriptura | `didit:verification` | `create:sessions` | Compara dues imatges facials (1:1). |
| `didit_verify_face_search` | Escriptura | `didit:verification` | `create:sessions` | Cerca una cara entre les cares verificades prèviament (1:N). |
| `didit_verify_age` | Escriptura | `didit:verification` | `create:sessions` | Estima l'edat d'una persona a partir d'una imatge facial. |
| `didit_verify_aml` | Escriptura | `didit:verification` | `create:sessions` | Cribra un nom contra sancions, PEP i llistes de vigilància, opcionalment amb mitjans adversos. |
| `didit_verify_email_send` | Escriptura | Qualsevol | — | Envia un codi d'un sol ús a una adreça de correu electrònic. |
| `didit_verify_email_check` | Escriptura | Qualsevol | — | Comprova el codi enviat a una adreça de correu electrònic. |
| `didit_verify_phone_send` | Escriptura | Qualsevol | — | Envia un codi d'un sol ús a un número de telèfon. |
| `didit_verify_phone_check` | Escriptura | Qualsevol | — | Comprova el codi enviat a un número de telèfon. |

***

## Monitoratge de transaccions

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_transaction_list` | Lectura | `didit:verification` | `list:transactions` | Enumera les transaccions monitoritzades d'una aplicació. Si no indiques cap àmbit, abasta totes les aplicacions. |
| `didit_transaction_create` | Escriptura | `didit:verification` | `create:transactions` | Envia una transacció per al monitoratge i l'avaluació de regles. |
| `didit_transaction_get` | Lectura | `didit:verification` | `list:transactions` | Una transacció monitoritzada amb el resultat de l'avaluació de regles. |
| `didit_transaction_screen_wallet` | Escriptura | `didit:verification` | `create:transactions` | Cribra una adreça de cartera de criptoactius per detectar risc AML sense crear una transacció. |
| `didit_transaction_rule_list` | Lectura | `didit:verification` | `list:transactions` | Enumera les regles de monitoratge de transaccions d'una aplicació. |
| `didit_transaction_rule_get` | Lectura | `didit:verification` | `list:transactions` | Una regla amb les seves condicions, agregació, àmbit, accions i comptadors. |
| `didit_transaction_rule_create` | Escriptura | `didit:verification` | `write:transactions` | Crea una regla personalitzada. |
| `didit_transaction_rule_update` | Escriptura | `didit:verification` | `write:transactions` | Actualitza parcialment una regla. |
| `didit_transaction_rule_delete` | Destructiu | `didit:verification` | `write:transactions` | Elimina una regla personalitzada. |
| `didit_transaction_rule_backtest` | Lectura | `didit:verification` | `list:transactions` | Simula una regla hipotètica sobre fins a les 10.000 transaccions més recents. No escriu res. |
| `didit_transaction_rule_library_list` | Lectura | `didit:verification` | `list:transactions` | Consulta la biblioteca de regles predefinides de Didit amb l'estat d'instal·lació. |
| `didit_transaction_rule_install` | Escriptura | `didit:verification` | `write:transactions` | Instal·la regles predefinides per clau de biblioteca o paquet. |
| `didit_transaction_rule_uninstall` | Destructiu | `didit:verification` | `write:transactions` | Elimina regles predefinides instal·lades per clau de biblioteca o paquet. |
| `didit_transaction_sdk_token` | Escriptura | Qualsevol | — | Genera un token de vida curta, vinculat a un únic usuari final, per enviar transaccions des dels SDK de client. |

***

## Travel Rule

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_travel_rule_get_settings` | Lectura | Qualsevol | — | La configuració de la Travel Rule: perfil de VASP, política de negociació, mètodes de prova, modes per xarxa i la teva Travel Address. |
| `didit_travel_rule_update_settings` | Escriptura | Qualsevol | — | Canvia la configuració de la Travel Rule; envia només els camps que vols modificar. Activar-la requereix un nom legal. |
| `didit_travel_rule_search_vasps` | Lectura | Qualsevol | — | Cerca al directori de VASP, amb puntuacions de diligència deguda i les xarxes en què es pot contactar amb cada VASP. |
| `didit_travel_rule_list_wallet_addresses` | Lectura | Qualsevol | — | La llibreta d'adreces de cartera on es resolen les transferències entrants, amb l'estat de verificació de titularitat de cada adreça. |
| `didit_travel_rule_add_wallet_address` | Escriptura | Qualsevol | — | Afegeix a la llibreta d'adreces una cartera que controles, opcionalment, ja verificada quant a la titularitat mitjançant autodeclaració. |
| `didit_travel_rule_update_wallet_address` | Escriptura | Qualsevol | — | Actualitza les dades del titular d'una entrada de la llibreta d'adreces. |
| `didit_travel_rule_delete_wallet_address` | Destructiva | Qualsevol | — | Esborra una entrada de la llibreta d'adreces; deixa de coincidir amb noves transferències immediatament. |
| `didit_travel_rule_confirm_ownership` | Destructiva | Qualsevol | — | Confirma o nega la titularitat de la cartera en una transferència que espera una prova de titularitat. |
| `didit_travel_rule_transfer_action` | Destructiva | Qualsevol | — | Finalitza una transferència sortint amb el seu hash on-chain, cancel·la una transferència que no és definitiva o torna a executar l'encaminament cap a la contrapart. |
| `didit_travel_rule_get_vasp` | Lectura | Qualsevol | — | Obté una entrada del directori de VASP pel seu id, amb els mateixos camps que una fila de cerca: rutes, llistats de xarxes, àlies, contactes i entitats. |
| `didit_travel_rule_list_networks` | Lectura | Qualsevol | — | L'estat de cada xarxa de la Travel Rule per a la teva aplicació, amb el motiu, el teu registre de participant i el qüestionari de diligència deguda. |
| `didit_travel_rule_request_network` | Escriptura | Qualsevol | — | Sol·licita unir-te a una xarxa de la Travel Rule com a participant. La sol·licitud espera fins que el qüestionari de diligència deguda sigui aprovat. |
| `didit_travel_rule_get_network_questionnaire` | Lectura | Qualsevol | — | El qüestionari de diligència deguda per a l'accés a la xarxa: estat, respostes desades, la nota del revisor i l'historial d'estats. |
| `didit_travel_rule_update_network_questionnaire` | Escriptura | Qualsevol | — | Desa respostes al borrador del qüestionari. Envia només les respostes que vols canviar. |
| `didit_travel_rule_submit_network_questionnaire` | Destructiva | Qualsevol | — | Envia a revisió el qüestionari desat. No es pot editar mentre està en revisió. |
| `didit_travel_rule_set_counterparty_vasp` | Escriptura | Qualsevol | — | Tria el VASP contrapart d'una transferència sortint que no s'ha pogut encaminar i torna a executar l'intercanvi cap a aquest VASP. |
| `didit_travel_rule_list_messages` | Lectura | Qualsevol | — | Els missatges i les sol·licituds de documents intercanviats amb el VASP contrapart en una transferència, dels més antics als més recents. |
| `didit_travel_rule_send_message` | Escriptura | Qualsevol | — | Envia un missatge o una sol·licitud de document al VASP contrapart d'una transferència. Només les transferències amb un altre client de Didit o per correu electrònic porten missatges. |
| `didit_travel_rule_list_counterparty_contacts` | Lectura | Qualsevol | — | Els contactes de compliment normatiu que s'usen per contactar amb un VASP contrapart per correu electrònic: els de la plataforma i els de la teva aplicació. |
| `didit_travel_rule_add_counterparty_contact` | Escriptura | Qualsevol | — | Afegeix un contacte de compliment normatiu per a un VASP del directori, privat per a la teva aplicació. |
| `didit_travel_rule_delete_counterparty_contact` | Destructiva | Qualsevol | — | Esborra un dels contactes de contrapart propis de la teva aplicació. |
| `didit_travel_rule_get_sandbox_scenarios` | Lectura | Qualsevol | — | El Didit Test VASP amb el qual intercanvien les aplicacions de sandbox, i els escenaris (acceptar, rebutjar, discrepància de nom, no accessible, temps d'espera exhaurit, autoallotjat) que selecciona cada adreça de cartera. |
| `didit_travel_rule_trigger_test_inbound` | Escriptura | Qualsevol | — | Només aplicacions de sandbox: fa que el Didit Test VASP t'enviï una transferència entrant de la Travel Rule. |

***

## Usuaris i empreses del proveïdor

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_vendor_user_list` | Lectura | `didit:management` | `list:users` | Llista els usuaris verificats agrupats per `vendor_data`. Si no dones cap àmbit, abasta totes les aplicacions. |
| `didit_vendor_user_create` | Escriptura | `didit:management` | `create:users` | Crea un registre d'usuari manualment. |
| `didit_vendor_user_get` | Lectura | `didit:management` | `read:users` | Un usuari per `vendor_data`. |
| `didit_vendor_user_update` | Escriptura | `didit:management` | `write:users` | Actualitza els camps del perfil d'un usuari. |
| `didit_vendor_user_update_status` | Escriptura | `didit:management` | `write:users` | Estableix l'estat d'un usuari a `ACTIVE`, `FLAGGED` o `BLOCKED`. |
| `didit_vendor_user_delete` | Destructiva | `didit:management` | `delete:users` | Esborra usuaris en lot per `vendor_data`, o esborra tots els usuaris. |
| `didit_vendor_business_list` | Lectura | `didit:verification` | `list:businesses` | Llista les empreses verificades agrupades per `vendor_data`. Si no dones cap àmbit, abasta totes les aplicacions. |
| `didit_vendor_business_create` | Escriptura | `didit:verification` | `create:businesses` | Crea un registre d'empresa manualment. |
| `didit_vendor_business_get` | Lectura | `didit:verification` | `read:businesses` | Una empresa per `vendor_data`. |
| `didit_vendor_business_update` | Escriptura | Qualsevol | — | Actualitza els camps del perfil d'una empresa. |
| `didit_vendor_business_update_status` | Escriptura | `didit:verification` | `write:businesses` | Estableix l'estat d'una empresa a `ACTIVE`, `FLAGGED` o `BLOCKED`. |
| `didit_vendor_business_delete` | Destructiva | `didit:verification` | `delete:businesses` | Esborra empreses en lot per `vendor_data` o id intern, o esborra totes les empreses. |

***

## Llistes, llista de bloqueig i llista de permesos

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_lists_list` | Lectura | `didit:management` | `read:lists` | Totes les llistes d'una aplicació: llistes de bloqueig, llistes de permesos i llistes personalitzades. |
| `didit_lists_create` | Escriptura | `didit:management` | `create:lists` | Crea una llista de permesos o una llista personalitzada. |
| `didit_lists_get` | Lectura | `didit:management` | `read:lists` | Una llista pel seu UUID. |
| `didit_lists_update` | Escriptura | `didit:management` | `write:lists` | Canvia el nom d'una llista o la seva descripció. |
| `didit_lists_delete` | Destructiva | `didit:management` | `delete:lists` | Elimina una llista i totes les seves entrades. |
| `didit_lists_entries_list` | Lectura | `didit:management` | `read:lists` | Les entrades d'una llista. |
| `didit_lists_entry_create` | Escriptura | `didit:management` | `create:lists` | Afegeix una entrada a una llista, per valor o des d'una sessió. |
| `didit_lists_entry_upload_face` | Escriptura | `didit:management` | `create:lists` | Afegeix una cara a una llista facial a partir d'una imatge, sense sessió. |
| `didit_lists_entry_delete` | Destructiva | `didit:management` | `delete:lists` | Elimina una entrada d'una llista. |
| `didit_blocklist_get` | Lectura | `didit:verification` | `read:blocklist` | Llista les entrades de la llista de bloqueig (auxiliar heretat). |
| `didit_blocklist_add` | Escriptura | `didit:verification` | `write:blocklist` | Afegeix una entrada a la llista de bloqueig (auxiliar heretat). |
| `didit_blocklist_remove` | Destructiva | `didit:verification` | `write:blocklist` | Elimina una entrada de la llista de bloqueig (auxiliar heretat). |
| `didit_allowlist_add` | Escriptura | `didit:verification` | `write:blocklist` | Afegeix una entrada a la llista de permesos (auxiliar heretat). |

***

## Casos

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_case_list` | Lectura | `didit:verification` | `list:cases` | Llista els casos d'una aplicació. Abasta totes les aplicacions si no indiques cap àmbit. |
| `didit_case_get` | Lectura | `didit:verification` | `read:cases` | Un cas amb els seus detalls. |
| `didit_case_create` | Escriptura | `didit:verification` | `write:cases` | Obre un cas. |
| `didit_case_statistics` | Lectura | `didit:verification` | `list:cases` | Recompte de casos per estat i altres estadístiques similars. |
| `didit_case_manage` | Destructiva | `didit:verification` | `write:cases` | Assigna, resol, reobre, escala, comenta o actualitza un cas. |

***

## Xarxes de frau

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_network_list` | Lectura | `didit:verification` | `list:networks` | Llista les xarxes de frau d'una aplicació, amb els filtres i els KPI de la consola. |
| `didit_network_get` | Lectura | `didit:verification` | `read:networks` | Una xarxa de frau amb els seus membres i senyals; graf, mapa i cronologia sota demanda. |
| `didit_network_membership_get` | Lectura | `didit:verification` | `read:networks` | Les xarxes de frau a les quals pertany una sessió, una sessió empresarial, un usuari, una empresa o una transacció. |

***

## Investigator

Aquestes eines apareixen a `tools/list` per a cada usuari que ha iniciat sessió, però només funcionen quan el [Investigator](https://docs.didit.me/ca/console/investigator.md) està habilitat per a la teva organització.

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_investigator_queue_list` | Lectura | Qualsevol | — | Llista els informes oberts de l'Investigator, la cua de revisió, amb la recomanació i la confiança de cadascun. |
| `didit_investigator_report_get` | Lectura | Qualsevol | — | Un informe de l'Investigator: recomanació, confiança, risc, narrativa, evidències, precedents i preguntes. |
| `didit_investigator_record_get` | Lectura | Qualsevol | — | La revisió més recent de l'Investigator d'una verificació o d'una transacció, oberta o decidida. |
| `didit_investigator_accept` | Destructiva | Qualsevol | — | Accepta la recomanació de l'Investigator per a un element; l'element es decideix i es registra amb el teu nom. |
| `didit_investigator_override` | Destructiva | Qualsevol | — | Decideix un element amb una altra acció, una categoria i un motiu en lloc de la recomanació. |
| `didit_investigator_batch_accept` | Destructiva | Qualsevol | — | Accepta fins a 50 recomanacions preparades alhora; un element que no es pot acceptar s'omet i es mostra el motiu. |
| `didit_investigator_add_note` | Escriptura | Qualsevol | — | Afegeix un fet sobre un element d'un informe com a nota d'equip que es llegirà en la revisió següent. |
| `didit_investigator_rereview` | Destructiva | Qualsevol | — | Demana a l'Investigator que torni a revisar un element; el nou informe substitueix l'informe obert. |
| `didit_investigator_question_list` | Lectura | Qualsevol | — | Les preguntes de política que planteja l'Investigator, de la més recent a la més antiga. |
| `didit_investigator_question_get` | Lectura | Qualsevol | — | Una pregunta de política amb les decisions de l'equip sobre aquesta situació durant els darrers 30 dies i les possibles respostes. |
| `didit_investigator_question_answer` | Destructiva | Qualsevol | — | Respon una pregunta de política; la majoria de respostes escriuen una nova versió de la política. |
| `didit_investigator_question_dismiss` | Destructiva | Qualsevol | — | Tanca una pregunta de política sense resposta. |
| `didit_investigator_backtest_start` | Escriptura | Qualsevol | — | Inicia un backtest gratuït que reprodueix la política actual sobre les decisions dels darrers 30 o 90 dies. No decideix res. |
| `didit_investigator_backtest_get` | Lectura | Qualsevol | — | Un backtest desat: concordança per cua, nivell i llindar. |
| `didit_investigator_performance_get` | Lectura | Qualsevol | — | La concordança de l'Investigator amb el teu equip, el volum, el temps estalviat i les anul·lacions durant 7, 30 o 90 dies. |
| `didit_investigator_dashboard_get` | Lectura | Qualsevol | — | El tauler de l'Investigator: automatització dels darrers 30 dies, historial setmanal, despesa i anul·lacions. |
| `didit_investigator_activity_list` | Lectura | Qualsevol | — | El registre d'activitat de l'Investigator, de la més recent a la més antiga: què han fet l'agent i les persones. |

***

## Informes, registre d'auditoria i alertes

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_report_list` | Lectura | Qualsevol | — | Llista els informes d'exportació. |
| `didit_report_get` | Lectura | Qualsevol | — | Estat i detalls d'un informe d'exportació. |
| `didit_report_get_download_url` | Lectura | Qualsevol | — | Una URL de descàrrega signada per a un informe acabat. |
| `didit_report_export` | Escriptura | Qualsevol | — | Inicia una exportació (sessions, transaccions, usuaris o empreses). |
| `didit_audit_log_list` | Lectura | Qualsevol | — | Entrades del registre d'auditoria d'una aplicació: qui ha canviat què. |
| `didit_alert_list` | Lectura | `didit:management` | `read:applications` | Les alertes configurades d'una aplicació. |
| `didit_alert_configure` | Escriptura | `didit:management` | `write:applications` | Configura una alerta d'un tipus determinat. |

***

## Webhooks

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_webhook_list` | Lectura | `didit:management` | `read:webhooks` | Les destinacions del webhook d'una aplicació. |
| `didit_webhook_create` | Escriptura | `didit:management` | `write:webhooks` | Crea una destinació del webhook. El secret de signatura es redacta a la resposta; copia'l des de la consola. |
| `didit_webhook_get` | Lectura | `didit:management` | `read:webhooks` | Una destinació del webhook, amb el secret de signatura redactat. |
| `didit_webhook_update` | Destructiva | `didit:management` | `write:webhooks` | Canvia la URL, la versió, l'indicador d'activació o els esdeveniments subscrits d'una destinació. |
| `didit_webhook_delete` | Destructiva | `didit:management` | `write:webhooks` | Elimina una destinació del webhook. |

***

## Mercat

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_marketplace_list_catalog` | Lectura | `didit:management` | `read:integrations` | El mercat de proveïdors: analítica de blockchain, cribratge AML, proveïdors de verificació de telèfon i de verificació bancària, i xarxes de Travel Rule, amb les credencials que necessita cadascun. |
| `didit_marketplace_list_connections` | Lectura | `didit:management` | `read:integrations` | Les connexions del mercat i les afiliacions a xarxes de la teva aplicació, amb l'estat i l'últim ús. Els secrets mai es retornen. |
| `didit_marketplace_request_integration` | Escriptura | `didit:management` | `write:integrations` | Sol·licita una integració que encara no està disponible en autoservei; l'equip de Didit fa el seguiment. |

***

## Organització, membres, facturació i marca

Dues eines d'aquest grup (`didit_org_top_up`, `didit_org_reveal_application_api_key`) estan definides al servidor però ocultes del catàleg de qualsevol cridador autenticat amb OAuth; només apareixen en un servidor stdio local.

| Eina | Tipus | Àmbit | Permís de rol | Què fa |
| - | - | - | - | - |
| `didit_org_list` | Lectura | Qualsevol | — | Les organitzacions a les quals pertanys. |
| `didit_org_list_applications` | Lectura | Qualsevol | — | Les aplicacions d'una organització. |
| `didit_org_get_application` | Lectura | Qualsevol | — | Detalls de l'aplicació, amb la clau d'API redactada. |
| `didit_org_reveal_application_api_key` | Destructiva | Qualsevol | — | Retorna la clau d'API de l'aplicació en text clar. Necessita identificadors explícits i `confirm: true`. Oculta al connector allotjat. |
| `didit_org_get_balance` | Lectura | `didit:management` | `read:subscription` | Saldo de crèdits i configuració de la recàrrega automàtica. |
| `didit_org_top_up` | Destructiva | Qualsevol | — | Crea una sessió de pagament de Stripe per afegir crèdits. Oculta al connector allotjat. |
| `didit_branding_get` | Lectura | `didit:management` | `read:customization` | La marca (logotips, colors) aplicada a la interfície de verificació. |
| `didit_branding_update` | Escriptura | `didit:management` | `write:customization` | Puja noves imatges de marca. |
| `didit_org_list_members` | Lectura | `didit:management` | `list:members` | Els membres d'una organització. |
| `didit_org_invite_member` | Escriptura | `didit:management` | `write:members` | Convida un membre per correu electrònic amb un rol. |
| `didit_org_update_member` | Escriptura | `didit:management` | `write:members` | Canvia el rol d'un membre. |
| `didit_org_remove_member` | Destructiva | `didit:management` | `delete:members` | Elimina un membre de l'organització. |
| `didit_org_list_roles` | Lectura | `didit:management` | `list:roles` | Els rols disponibles a l'organització. |
| `didit_org_list_api_keys` | Lectura | `didit:management` | `read:applications` | Metadades de les claus d'API amb els valors bruts redactats. |

***

## Fitxers d'entrada

Les eines que reben un fitxer (`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`) l'accepten en una de les dues formes següents:

* `*_base64`: el contingut del fitxer en línia, com a base64 en brut o com a URL `data:`. Utilitza aquesta forma amb l'endpoint allotjat.
* `*_path`: una ruta absoluta a la màquina que executa el servidor. Només funciona amb un servidor stdio local que comparteix un sistema de fitxers amb tu.

Les dues formes apliquen un límit de 15 MB i una llista de bytes màgics permesos (PNG, JPG, WebP, GIF, BMP, ICO, PDF). El transport allotjat accepta cossos JSON de fins a 25 MB.

***

> [card] [Exemples](https://docs.didit.me/ca/integration/mcp/examples.md)
>
> Converses que utilitzen aquestes eines de principi a fi.

> [card] [Avançat](https://docs.didit.me/ca/integration/mcp/advanced.md)
>
> Rols, comportament entre aplicacions, flux de treball amb branques, webhooks, autoallotjament.


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