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

# Ferramentas MCP da Didit: referência de 169 ferramentas

> Todas as ferramentas do servidor MCP hospedado do Didit, por área, com tipo (leitura/escrita/destrutiva), escopo OAuth e permissão de função.

O servidor hospedado em `https://mcp.didit.me/mcp` oferece a um usuário autenticado **169 ferramentas**: 80 de leitura, 62 de escrita e 27 destrutivas.
As 17 [ferramentas do Investigator](#investigator) também estão listadas, mas só funcionam depois que o Investigator é ativado para a sua organização.
Outras duas (`didit_org_top_up` e `didit_org_reveal_application_api_key`) ficam ocultas em todos os catálogos autenticados via OAuth e só aparecem em um servidor stdio local, que também adiciona cinco ferramentas de configuração de conta (veja [auto-hospedagem](https://docs.didit.me/pt-br/integration/mcp/installation.md#auto-hospedagem)).

Esta página é gerada a partir do registro de ferramentas em [`didit-protocol/mcp`](https://github.com/didit-protocol/mcp) (`src/index.ts`, a versão que o servidor hospedado informa em `serverInfo`). Nomes, tipos e argumentos obrigatórios vêm da própria resposta `tools/list` do servidor; a permissão da função vem de `src/permissions.ts`.

## Como ler a tabela

| Coluna | Significado |
| - | - |
| **Tipo** | Vem das anotações MCP da ferramenta. **Leitura** é somente leitura. **Escrita** cria ou altera algo. **Destrutiva** exclui ou sobrescreve dados, altera algo que entra em vigor imediatamente (um fluxo publicado, uma decisão de sessão), revela um segredo ou movimenta dinheiro; os clientes pedem confirmação antes de executá-las. Verificações avulsas cobráveis contam como escrita. |
| **Escopo** | O escopo OAuth cujos recursos incluem a permissão da função exigida pela ferramenta: `didit:verification` para sessões, empresas, casos, redes, transações e a lista de bloqueio; `didit:management` para fluxos, questionários, listas, webhooks, integrações, membros, funções, chaves de API, registros de auditoria, a organização, aplicações, assinatura e usuários. **Qualquer um** indica analytics, que ambos os escopos incluem, ou uma ferramenta sem verificação por função, que é executada sob o escopo que você aprovou. Veja [Autenticação](https://docs.didit.me/pt-br/integration/mcp/authentication.md#escopos). |
| **Permissão da função** | A permissão que a função da sua organização precisa ter, conforme verificada pelo backend da Didit. Um travessão indica que o endpoint é delimitado pela associação à organização ou não tem verificação por função. Quando a sua função não tem a permissão, a ferramenta retorna um erro `missing_scope` que a identifica. |

Toda ferramenta aceita `organization_id` e `application_id` opcionais para fixar um escopo. Com uma única organização e aplicação, eles são resolvidos para você; com várias, as ferramentas `*_search` e `didit_analytics` abrangem todas elas, e as ferramentas `*_list` por aplicação fazem o mesmo quando você não informa um escopo.

> [!NOTE]
>
> `didit_session_delete` e `didit_session_batch_delete` se recusam a ser executadas sem `confirm: true` nos argumentos, assim como as ferramentas de decisão do Investigator (`accept`, `override`, `batch_accept`, `rereview`, `question_answer`, `question_dismiss`) e a `didit_org_reveal_application_api_key`, disponível apenas localmente. `didit_case_manage` exige isso ao registrar um SAR, e `didit_vendor_user_delete` e `didit_vendor_business_delete` exigem isso quando `delete_all` é true.

***

## Descoberta e recursos entre aplicações

Estas ferramentas abrangem, em uma única chamada, todas as organizações e aplicações que você pode acessar; cada linha é marcada com a organização e a aplicação correspondentes.

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_context_get` | Leitura | Qualquer um | — | Todas as organizações e aplicações que você pode acessar, em uma estrutura aninhada, além da organização e da aplicação padrão quando há apenas uma organização e uma aplicação. Chame-a primeiro. |
| `didit_session_search` | Leitura | `didit:verification` | `list:sessions` | Pesquisa sessões de verificação em todas as suas aplicações e organizações, das mais recentes para as mais antigas. |
| `didit_transaction_search` | Leitura | `didit:verification` | `list:transactions` | Pesquisa transações monitoradas em todas as suas aplicações e organizações. |
| `didit_case_search` | Leitura | `didit:verification` | `list:cases` | Pesquisa casos de investigação em todas as suas aplicações e organizações. |
| `didit_vendor_user_search` | Leitura | `didit:management` | `list:users` | Encontra um cliente final por nome, e-mail ou `vendor_data` em todas as suas aplicações. |
| `didit_vendor_business_search` | Leitura | `didit:verification` | `list:businesses` | Encontra uma empresa de KYB em todas as suas aplicações. |
| `didit_workflow_search` | Leitura | `didit:management` | `read:workflows` | Encontra um fluxo por id ou rótulo em todas as suas aplicações; o resultado informa a qual organização e aplicação ele pertence. |
| `didit_analytics` | Leitura | Qualquer um | `read:analytics` | Analytics agregados para um intervalo de datas (detalhamento de requisições, funil de recursos, taxa de conversão) em todas as suas aplicações. |

***

## Sessões (KYC e KYB)

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_session_create` | Escrita | `didit:verification` | `create:sessions` ou `write:sessions` | Cria uma sessão de verificação para um fluxo. Retorna `session_id`, `url` e `session_token`. |
| `didit_session_list` | Leitura | `didit:verification` | `list:sessions` | Lista as sessões de uma aplicação. Abrange todas as aplicações quando você não informa um escopo. |
| `didit_session_get_decision` | Leitura | `didit:verification` | `read:sessions` | A decisão completa e todos os dados extraídos de uma sessão. |
| `didit_session_get_location_evidence` | Leitura | `didit:verification` | `read:sessions` | As evidências de Precise Location de uma sessão para cada etapa de localização: a configuração que a avaliou, o veredito, cada tentativa, os pontos de referência, as distâncias e as áreas. |
| `didit_session_update_status` | Destrutiva | `didit:verification` | `write:sessions` | Aprova, recusa ou solicita o reenvio de uma sessão. |
| `didit_session_update_data` | Escrita | `didit:verification` | `write:sessions` | Corrige os dados extraídos do documento de identidade (alteração feita pelo revisor). |
| `didit_session_update_poa_data` | Escrita | `didit:verification` | `write:sessions` | Corrige os dados extraídos do documento comprobatório de endereço. |
| `didit_session_delete` | Destrutiva | `didit:verification` | `delete:sessions` | Exclui permanentemente uma sessão, com seus dados de verificação e mídias. Exige `confirm: true`. |
| `didit_session_batch_delete` | Destrutiva | `didit:verification` | `delete:sessions` | Exclui permanentemente várias sessões de KYC pelo número da sessão, ou todas as sessões de KYC da aplicação. Exige `confirm: true`. As sessões de KYB nunca são afetadas. |
| `didit_session_generate_pdf` | Escrita | `didit:verification` | `read:sessions` | Gera um relatório de verificação em PDF para uma sessão. |
| `didit_session_list_reviews` | Leitura | `didit:verification` | `read:sessions` | O histórico de revisões e o registro de atividades de uma sessão. |
| `didit_session_add_review` | Escrita | `didit:verification` | `write:sessions` | Adiciona uma nota de revisão a uma sessão, com a opção de alterar seu status. |
| `didit_session_share` | Escrita | `didit:verification` | `write:sessions` | Compartilha uma sessão verificada com um parceiro de confiança (KYC reutilizável). |
| `didit_session_import_shared` | Escrita | Qualquer um | — | Importa uma sessão que um parceiro compartilhou com você (KYC reutilizável). |
| `didit_session_create_import` | Escrita | Qualquer um | — | Inicia um job de importação em massa a partir de um arquivo CSV ou NDJSON hospedado. |
| `didit_session_get_import_template` | Leitura | Qualquer um | — | Baixa o modelo de importação (cabeçalhos das colunas e formato). |
| `didit_session_get_import` | Leitura | Qualquer um | — | Status e resumo de um job de importação em massa. |
| `didit_session_get_import_errors` | Leitura | Qualquer um | — | Falhas por linha de um job de importação em massa. |
| `didit_session_explain_decision` | Leitura | `didit:verification` | `read:sessions` | Por que uma sessão terminou como Aprovada, Recusada ou Em revisão: o recurso decisivo, cada aviso que teve efeito, cada regra de status acionada, qualquer alteração feita pelo revisor e a configuração do fluxo por trás de cada causa. |
| `didit_session_webhooks` | Leitura | `didit:verification` | `read:sessions` | As entregas de webhook enviadas para uma sessão nos últimos 30 dias: destino, status HTTP, tempos, cabeçalhos de assinatura e uma cópia limitada do payload. |
| `didit_session_webhook_resend` | Escrita | `didit:verification` | `create:sessions` | Reenvia uma entrega de webhook registrada de uma sessão para o endpoint configurado, por exemplo, depois que o endpoint foi corrigido. |

***

## Fluxos de verificação

Os fluxos de verificação (workflows) simples são uma lista linear de recursos; os fluxos em grafo adicionam ramificações, condições e etapas de Document AI. Consulte [Avançado: fluxos com ramificações](https://docs.didit.me/pt-br/integration/mcp/advanced.md#fluxos-com-ramificações).

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_workflow_list` | Leitura | `didit:management` | `read:workflows` | Lista os fluxos de verificação. Abrange todas as aplicações quando você não informa um escopo. |
| `didit_workflow_create` | Escrita | `didit:management` | `write:workflows` | Cria um fluxo simples e linear a partir de uma lista ordenada de recursos. Publica o fluxo, a menos que você passe `status: "draft"`. |
| `didit_workflow_get` | Leitura | `didit:management` | `read:workflows` | A configuração completa de um fluxo, incluindo quais dados são retornados por recurso. |
| `didit_workflow_update` | Destrutiva | `didit:management` | `write:workflows` | Altera as configurações de nível superior de um fluxo (rótulo, indicador padrão, tentativas, expiração, marca branca, listas de permissões). |
| `didit_workflow_delete` | Destrutiva | `didit:management` | `write:workflows` | Exclui um fluxo em rascunho. |
| `didit_workflow_get_graph` | Leitura | `didit:management` | `read:workflows` | O grafo de nós de um fluxo, com seu status e se pode ser editado. Configurações grandes são resumidas, a menos que você as solicite. |
| `didit_workflow_get_field_definitions` | Leitura | `didit:management` | `read:workflows` | Todos os campos que podem ser usados em ramificações e os operadores que cada um aceita. |
| `didit_workflow_get_feature_config_schema` | Leitura | Qualquer um | — | Todas as chaves de `config` que cada recurso do fluxo aceita, com tipo, limites, valor padrão e significado. |
| `didit_workflow_get_id_verification_methods_catalog` | Leitura | `didit:management` | `read:workflows` | Por país, quais consultas sem documento e carteiras de identidade digital são oferecidas, se estão ativas e seus preços de consulta no catálogo. |
| `didit_workflow_get_kyb_registry_catalog` | Leitura | Qualquer um | — | Por país, quais níveis de dados de empresas os registros de empresas oferecem e se o monitoramento de registros de empresas é vendido, com preços. Não exige organização nem aplicação. |
| `didit_workflow_get_branch_fields` | Leitura | `didit:management` | `read:workflows` | Os campos disponíveis em um ponto de ramificação de um grafo candidato. |
| `didit_workflow_validate_graph` | Leitura | `didit:management` | `read:workflows` | Validação de teste de um grafo completo. Não salva nada. |
| `didit_workflow_edit_graph` | Destrutiva | `didit:management` | `write:workflows` | Modifica um grafo existente com pequenas operações; o servidor busca o grafo completo por conta própria e salva um rascunho. |
| `didit_workflow_set_graph` | Destrutiva | `didit:management` | `write:workflows` | Substitui o grafo inteiro de um fluxo. Salva um rascunho; a publicação é uma etapa separada. |
| `didit_workflow_create_draft` | Escrita | `didit:management` | `write:workflows` | Cria um rascunho editável a partir de um fluxo publicado. |
| `didit_workflow_publish` | Destrutiva | `didit:management` | `write:workflows` | Publica o rascunho pendente para que as novas sessões o utilizem. |
| `didit_workflow_build_graph` | Leitura | `didit:management` | `read:workflows` | Monta um grafo completo a partir de uma especificação simples de recursos, sem salvar nada. |

***

## Assistente de conformidade

Crie um fluxo a partir do seu perfil regulatório: uma entrevista adaptativa, as obrigações que se aplicam a você com citações e um fluxo multipaís gerado automaticamente.

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_compliance_interview_next` | Leitura | `didit:management` | `read:workflows` | A próxima pergunta da entrevista adaptativa de conformidade, ou `done` quando ela estiver concluída. Envie todas as respostas coletadas até o momento a cada chamada. |
| `didit_compliance_profile_get` | Leitura | `didit:management` | `read:workflows` | Seu perfil de conformidade armazenado: as respostas da entrevista e os atributos derivados delas. |
| `didit_compliance_profile_set` | Destrutiva | `didit:management` | `write:workflows` | Armazena as respostas da entrevista concluída, substituindo qualquer perfil de conformidade existente. |
| `didit_compliance_requirements` | Leitura | `didit:management` | `read:workflows` | As obrigações regulatórias que se aplicam a você, com citações, derivadas do perfil armazenado. |
| `didit_compliance_generate_workflow` | Leitura | `didit:management` | `read:workflows` | Gera um grafo de um fluxo multipaís a partir do perfil armazenado: um tronco comum mais ramificações por país com as verificações que cada país exige. |
| `didit_compliance_check_workflow` | Leitura | `didit:management` | `read:workflows` | Verifica quais obrigações uma versão do fluxo atende ou viola, com citações. |

***

## Questionários

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_questionnaire_list` | Leitura | `didit:management` | `read:questionnaires` | Lista os questionários personalizados de uma aplicação. |
| `didit_questionnaire_create` | Escrita | `didit:management` | `write:questionnaires` | Cria um questionário a partir de uma lista ordenada de perguntas. |
| `didit_questionnaire_append_choices` | Escrita | `didit:management` | `write:questionnaires` | Adiciona opções de resposta a uma pergunta de um questionário em rascunho. |
| `didit_questionnaire_get` | Leitura | `didit:management` | `read:questionnaires` | As perguntas e opções de um questionário. |
| `didit_questionnaire_update` | Destrutiva | `didit:management` | `write:questionnaires` | Atualiza o título, a descrição ou as perguntas de um questionário. |
| `didit_questionnaire_delete` | Destrutiva | `didit:management` | `write:questionnaires` | Exclui um questionário. |

***

## APIs de verificação independentes

Chamadas avulsas cobradas, sem sessão. Todas são requisições POST e consomem créditos, mesmo as que parecem uma consulta (`kyb_search`, `face_search`).

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_verify_id` | Escrita | `didit:verification` | `create:sessions` | Verifica um documento de identidade a partir da imagem da frente (e, opcionalmente, do verso). |
| `didit_verify_poa` | Escrita | `didit:verification` | `create:sessions` | Verifica um comprovante de endereço. |
| `didit_verify_database` | Escrita | `didit:verification` | `create:sessions` | Confere dados de identidade com fontes oficiais nacionais e globais. |
| `didit_verify_kyb_search` | Escrita | `didit:verification` | `create:sessions` | Pesquisa registros de empresas oficiais por nome ou número de registro e retorna candidatos. |
| `didit_verify_kyb_select` | Escrita | `didit:verification` | `create:sessions` | Obtém o registro completo de um candidato retornado por `didit_verify_kyb_search`. |
| `didit_verify_passive_liveness` | Escrita | `didit:verification` | `create:sessions` | Prova de vida passiva a partir de uma única imagem. |
| `didit_verify_face_match` | Escrita | `didit:verification` | `create:sessions` | Compara duas imagens faciais (1:1). |
| `didit_verify_face_search` | Escrita | `didit:verification` | `create:sessions` | Busca um rosto entre rostos verificados anteriormente (1:N). |
| `didit_verify_age` | Escrita | `didit:verification` | `create:sessions` | Estima a idade de uma pessoa a partir de uma imagem facial. |
| `didit_verify_aml` | Escrita | `didit:verification` | `create:sessions` | Verifica um nome em listas de sanções, de PEP e de monitoramento e, opcionalmente, em mídia adversa. |
| `didit_verify_email_send` | Escrita | Qualquer um | — | Envia um código de uso único para um endereço de e-mail. |
| `didit_verify_email_check` | Escrita | Qualquer um | — | Confere o código enviado para um endereço de e-mail. |
| `didit_verify_phone_send` | Escrita | Qualquer um | — | Envia um código de uso único para um número de telefone. |
| `didit_verify_phone_check` | Escrita | Qualquer um | — | Confere o código enviado para um número de telefone. |

***

## Monitoramento de transações

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_transaction_list` | Leitura | `didit:verification` | `list:transactions` | Lista as transações monitoradas em um app. Abrange todos os apps quando você não informa um escopo. |
| `didit_transaction_create` | Escrita | `didit:verification` | `create:transactions` | Envia uma transação para monitoramento e avaliação de regras. |
| `didit_transaction_get` | Leitura | `didit:verification` | `list:transactions` | Uma transação monitorada com o resultado da avaliação de regras. |
| `didit_transaction_screen_wallet` | Escrita | `didit:verification` | `create:transactions` | Faz a triagem do endereço de uma carteira cripto quanto a riscos de AML sem criar uma transação. |
| `didit_transaction_rule_list` | Leitura | `didit:verification` | `list:transactions` | Lista as regras de monitoramento de transações de um app. |
| `didit_transaction_rule_get` | Leitura | `didit:verification` | `list:transactions` | Uma regra com suas condições, agregação, escopo, ações e contadores. |
| `didit_transaction_rule_create` | Escrita | `didit:verification` | `write:transactions` | Cria uma regra personalizada. |
| `didit_transaction_rule_update` | Escrita | `didit:verification` | `write:transactions` | Atualiza parcialmente uma regra. |
| `didit_transaction_rule_delete` | Destrutiva | `didit:verification` | `write:transactions` | Exclui uma regra personalizada. |
| `didit_transaction_rule_backtest` | Leitura | `didit:verification` | `list:transactions` | Simula uma regra hipotética em relação a até 10.000 das transações mais recentes. Não grava nada. |
| `didit_transaction_rule_library_list` | Leitura | `didit:verification` | `list:transactions` | Navega pela biblioteca de regras predefinidas da Didit, com o status de instalação. |
| `didit_transaction_rule_install` | Escrita | `didit:verification` | `write:transactions` | Instala regras predefinidas por chave da biblioteca ou por pacote. |
| `didit_transaction_rule_uninstall` | Destrutiva | `didit:verification` | `write:transactions` | Remove regras predefinidas instaladas por chave da biblioteca ou por pacote. |
| `didit_transaction_sdk_token` | Escrita | Qualquer um | — | Gera um token de curta duração, vinculado a um usuário final, para enviar transações pelos SDKs de cliente. |

***

## Travel Rule

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_travel_rule_get_settings` | Leitura | Qualquer um | — | Suas configurações de Travel Rule: perfil de VASP, política de negociação, métodos de comprovação, modos por rede e seu endereço de Travel Rule. |
| `didit_travel_rule_update_settings` | Escrita | Qualquer um | — | Altera as configurações de Travel Rule; envie apenas os campos a alterar. A ativação exige uma razão social. |
| `didit_travel_rule_search_vasps` | Leitura | Qualquer um | — | Pesquisa o diretório de VASPs, com as pontuações de due diligence e as redes em que cada VASP está acessível. |
| `didit_travel_rule_list_wallet_addresses` | Leitura | Qualquer um | — | O catálogo de endereços de carteira usado para associar transferências recebidas, com o estado de verificação de propriedade de cada endereço. |
| `didit_travel_rule_add_wallet_address` | Escrita | Qualquer um | — | Adiciona ao catálogo de endereços uma carteira que você controla, opcionalmente já com a propriedade verificada por autodeclaração. |
| `didit_travel_rule_update_wallet_address` | Escrita | Qualquer um | — | Atualiza os dados do titular de uma entrada do catálogo de endereços. |
| `didit_travel_rule_delete_wallet_address` | Destrutiva | Qualquer um | — | Exclui uma entrada do catálogo de endereços; ela deixa de corresponder a novas transferências imediatamente. |
| `didit_travel_rule_confirm_ownership` | Destrutiva | Qualquer um | — | Confirma ou nega a propriedade da carteira em uma transferência que aguarda uma prova de propriedade. |
| `didit_travel_rule_transfer_action` | Destrutiva | Qualquer um | — | Conclui uma transferência enviada informando seu hash on-chain, cancela uma transferência que ainda não foi finalizada ou executa novamente o roteamento para a contraparte. |
| `didit_travel_rule_get_vasp` | Leitura | Qualquer um | — | Obtém uma entrada do diretório de VASPs pelo id, com os mesmos campos de uma linha de pesquisa: rotas, listagens em redes, aliases, contatos e entidades. |
| `didit_travel_rule_list_networks` | Leitura | Qualquer um | — | O estado de cada rede de Travel Rule para a sua aplicação, com o motivo, o seu registro de participante e o questionário de due diligence. |
| `didit_travel_rule_request_network` | Escrita | Qualquer um | — | Solicita a entrada em uma rede de Travel Rule como participante. A solicitação fica em espera até que o questionário de due diligence seja aprovado. |
| `didit_travel_rule_get_network_questionnaire` | Leitura | Qualquer um | — | O questionário de due diligence para acesso à rede: status, respostas salvas, a nota do revisor e o histórico de status. |
| `didit_travel_rule_update_network_questionnaire` | Escrita | Qualquer um | — | Salva respostas no rascunho do questionário. Envie apenas as respostas a alterar. |
| `didit_travel_rule_submit_network_questionnaire` | Destrutiva | Qualquer um | — | Envia o questionário salvo para revisão. Ele não pode ser editado enquanto estiver em revisão. |
| `didit_travel_rule_set_counterparty_vasp` | Escrita | Qualquer um | — | Escolhe o VASP da contraparte de uma transferência enviada que não pôde ser roteada e executa novamente a troca com ele. |
| `didit_travel_rule_list_messages` | Leitura | Qualquer um | — | As mensagens e solicitações de documentos trocadas com o VASP da contraparte em uma transferência, das mais antigas para as mais recentes. |
| `didit_travel_rule_send_message` | Escrita | Qualquer um | — | Envia uma mensagem ou uma solicitação de documento ao VASP da contraparte de uma transferência. Somente transferências com outro cliente da Didit ou por e-mail suportam mensagens. |
| `didit_travel_rule_list_counterparty_contacts` | Leitura | Qualquer um | — | Os contatos de conformidade usados para contatar o VASP de uma contraparte por e-mail: os da plataforma e os da própria aplicação. |
| `didit_travel_rule_add_counterparty_contact` | Escrita | Qualquer um | — | Adiciona um contato de conformidade para um VASP do diretório, exclusivo da sua aplicação. |
| `didit_travel_rule_delete_counterparty_contact` | Destrutiva | Qualquer um | — | Exclui um dos contatos de contraparte da própria aplicação. |
| `didit_travel_rule_get_sandbox_scenarios` | Leitura | Qualquer um | — | O Didit Test VASP com o qual as aplicações de sandbox trocam informações e os cenários (aceitação, recusa, divergência de nome, inacessível, tempo esgotado, carteira autocustodiada) que cada endereço de carteira seleciona. |
| `didit_travel_rule_trigger_test_inbound` | Escrita | Qualquer um | — | Somente aplicações de sandbox: faz o Didit Test VASP enviar a você uma transferência de Travel Rule recebida. |

***

## Usuários e empresas do fornecedor

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_vendor_user_list` | Leitura | `didit:management` | `list:users` | Lista os usuários verificados agrupados por `vendor_data`. Abrange todas as aplicações quando você não informa um escopo. |
| `didit_vendor_user_create` | Escrita | `didit:management` | `create:users` | Cria um registro de usuário manualmente. |
| `didit_vendor_user_get` | Leitura | `didit:management` | `read:users` | Um usuário por `vendor_data`. |
| `didit_vendor_user_update` | Escrita | `didit:management` | `write:users` | Atualiza os campos de perfil de um usuário. |
| `didit_vendor_user_update_status` | Escrita | `didit:management` | `write:users` | Define o status de um usuário como `ACTIVE`, `FLAGGED` ou `BLOCKED`. |
| `didit_vendor_user_delete` | Destrutiva | `didit:management` | `delete:users` | Exclui usuários em lote por `vendor_data` ou exclui todos os usuários. |
| `didit_vendor_business_list` | Leitura | `didit:verification` | `list:businesses` | Lista as empresas verificadas agrupadas por `vendor_data`. Abrange todas as aplicações quando você não informa um escopo. |
| `didit_vendor_business_create` | Escrita | `didit:verification` | `create:businesses` | Cria um registro de empresa manualmente. |
| `didit_vendor_business_get` | Leitura | `didit:verification` | `read:businesses` | Uma empresa por `vendor_data`. |
| `didit_vendor_business_update` | Escrita | Qualquer um | — | Atualiza os campos de perfil de uma empresa. |
| `didit_vendor_business_update_status` | Escrita | `didit:verification` | `write:businesses` | Define o status de uma empresa como `ACTIVE`, `FLAGGED` ou `BLOCKED`. |
| `didit_vendor_business_delete` | Destrutiva | `didit:verification` | `delete:businesses` | Exclui empresas em lote por `vendor_data` ou id interno, ou exclui todas as empresas. |

***

## Listas, lista de bloqueio e lista de permissão

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_lists_list` | Leitura | `didit:management` | `read:lists` | Todas as listas de uma aplicação: listas de bloqueio, listas de permissão e listas personalizadas. |
| `didit_lists_create` | Escrita | `didit:management` | `create:lists` | Cria uma lista de permissão ou uma lista personalizada. |
| `didit_lists_get` | Leitura | `didit:management` | `read:lists` | Uma lista pelo UUID. |
| `didit_lists_update` | Escrita | `didit:management` | `write:lists` | Renomeia uma lista ou altera sua descrição. |
| `didit_lists_delete` | Destrutiva | `didit:management` | `delete:lists` | Exclui uma lista e todas as suas entradas. |
| `didit_lists_entries_list` | Leitura | `didit:management` | `read:lists` | As entradas de uma lista. |
| `didit_lists_entry_create` | Escrita | `didit:management` | `create:lists` | Adiciona uma entrada a uma lista, por valor ou a partir de uma sessão. |
| `didit_lists_entry_upload_face` | Escrita | `didit:management` | `create:lists` | Adiciona um rosto a uma lista de rostos a partir de uma imagem, sem sessão. |
| `didit_lists_entry_delete` | Destrutiva | `didit:management` | `delete:lists` | Remove uma entrada de uma lista. |
| `didit_blocklist_get` | Leitura | `didit:verification` | `read:blocklist` | Lista as entradas da lista de bloqueio (auxiliar legado). |
| `didit_blocklist_add` | Escrita | `didit:verification` | `write:blocklist` | Adiciona uma entrada à lista de bloqueio (auxiliar legado). |
| `didit_blocklist_remove` | Destrutiva | `didit:verification` | `write:blocklist` | Remove uma entrada da lista de bloqueio (auxiliar legado). |
| `didit_allowlist_add` | Escrita | `didit:verification` | `write:blocklist` | Adiciona uma entrada à lista de permissão (auxiliar legado). |

***

## Casos

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_case_list` | Leitura | `didit:verification` | `list:cases` | Lista os casos de uma aplicação. Abrange todas as aplicações quando você não informa um escopo. |
| `didit_case_get` | Leitura | `didit:verification` | `read:cases` | Um caso com seus detalhes. |
| `didit_case_create` | Escrita | `didit:verification` | `write:cases` | Abre um caso. |
| `didit_case_statistics` | Leitura | `didit:verification` | `list:cases` | Contagem de casos por status e estatísticas semelhantes. |
| `didit_case_manage` | Destrutiva | `didit:verification` | `write:cases` | Atribui, resolve, reabre, escala, comenta ou atualiza um caso. |

***

## Redes de fraude

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_network_list` | Leitura | `didit:verification` | `list:networks` | Lista as redes de fraude de uma aplicação, com os filtros e KPIs do console. |
| `didit_network_get` | Leitura | `didit:verification` | `read:networks` | Uma rede de fraude com seus membros e sinais; grafo, mapa e linha do tempo mediante solicitação. |
| `didit_network_membership_get` | Leitura | `didit:verification` | `read:networks` | As redes de fraude às quais pertence uma sessão, uma sessão de empresa, um usuário, uma empresa ou uma transação. |

***

## Investigator

Estas ferramentas aparecem em `tools/list` para todo usuário conectado, mas só funcionam depois que o [Investigator](https://docs.didit.me/pt-br/console/investigator.md) é ativado para a sua organização.

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_investigator_queue_list` | Leitura | Qualquer um | — | Lista os relatórios abertos do Investigator, ou seja, a fila de revisão, com a recomendação e a confiança de cada um. |
| `didit_investigator_report_get` | Leitura | Qualquer um | — | Um relatório do Investigator: recomendação, confiança, risco, narrativa, evidências, precedentes e perguntas. |
| `didit_investigator_record_get` | Leitura | Qualquer um | — | A revisão mais recente do Investigator sobre uma verificação ou transação em aberto ou decidida. |
| `didit_investigator_accept` | Destrutiva | Qualquer um | — | Aceita a recomendação do Investigator sobre um item; o item é decidido e registrado em seu nome. |
| `didit_investigator_override` | Destrutiva | Qualquer um | — | Decide um item com outra ação, uma categoria e um motivo em vez da recomendação. |
| `didit_investigator_batch_accept` | Destrutiva | Qualquer um | — | Aceita até 50 recomendações prontas de uma só vez; um item que não pode ser aceito é ignorado, com o motivo. |
| `didit_investigator_add_note` | Escrita | Qualquer um | — | Adiciona um fato sobre o item de um relatório como nota da equipe, que será lida na próxima revisão. |
| `didit_investigator_rereview` | Destrutiva | Qualquer um | — | Pede ao Investigator que revise um item novamente; o novo relatório substitui o que está aberto. |
| `didit_investigator_question_list` | Leitura | Qualquer um | — | As perguntas de política levantadas pelo Investigator, das mais recentes para as mais antigas. |
| `didit_investigator_question_get` | Leitura | Qualquer um | — | Uma pergunta de política com as decisões da equipe nos últimos 30 dias nessa situação e as respostas possíveis. |
| `didit_investigator_question_answer` | Destrutiva | Qualquer um | — | Responde a uma pergunta de política; a maioria das respostas grava uma nova versão da política. |
| `didit_investigator_question_dismiss` | Destrutiva | Qualquer um | — | Encerra uma pergunta de política sem resposta. |
| `didit_investigator_backtest_start` | Escrita | Qualquer um | — | Inicia um backtest gratuito que reaplica a política atual às decisões dos últimos 30 ou 90 dias. Ele não decide nada. |
| `didit_investigator_backtest_get` | Leitura | Qualquer um | — | Um backtest armazenado: concordância por fila, nível e limiar. |
| `didit_investigator_performance_get` | Leitura | Qualquer um | — | A concordância do Investigator com a sua equipe, volume, tempo economizado e substituições em 7, 30 ou 90 dias. |
| `didit_investigator_dashboard_get` | Leitura | Qualquer um | — | O painel do Investigator: automação em 30 dias, histórico semanal, gastos e substituições. |
| `didit_investigator_activity_list` | Leitura | Qualquer um | — | O registro de atividades do Investigator, do mais recente para o mais antigo: o que o agente e as pessoas fizeram. |

***

## Relatórios, registro de auditoria e alertas

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_report_list` | Leitura | Qualquer um | — | Lista os relatórios de exportação. |
| `didit_report_get` | Leitura | Qualquer um | — | Status e detalhes de um relatório de exportação. |
| `didit_report_get_download_url` | Leitura | Qualquer um | — | Uma URL de download assinada para um relatório concluído. |
| `didit_report_export` | Escrita | Qualquer um | — | Inicia uma exportação (sessões, transações, usuários ou empresas). |
| `didit_audit_log_list` | Leitura | Qualquer um | — | Entradas do registro de auditoria de uma aplicação: quem alterou o quê. |
| `didit_alert_list` | Leitura | `didit:management` | `read:applications` | Os alertas configurados em uma aplicação. |
| `didit_alert_configure` | Escrita | `didit:management` | `write:applications` | Configura um alerta por tipo. |

***

## Webhooks

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_webhook_list` | Leitura | `didit:management` | `read:webhooks` | Os destinos de webhook de uma aplicação. |
| `didit_webhook_create` | Escrita | `didit:management` | `write:webhooks` | Cria um destino de webhook. O segredo de assinatura é ocultado na resposta; copie-o do console. |
| `didit_webhook_get` | Leitura | `didit:management` | `read:webhooks` | Um destino de webhook, com o segredo de assinatura ocultado. |
| `didit_webhook_update` | Destrutiva | `didit:management` | `write:webhooks` | Altera a URL, a versão, o indicador de ativação ou os eventos aos quais está inscrito de um destino. |
| `didit_webhook_delete` | Destrutiva | `didit:management` | `write:webhooks` | Exclui um destino de webhook. |

***

## Marketplace

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_marketplace_list_catalog` | Leitura | `didit:management` | `read:integrations` | O marketplace de provedores: análise de blockchain, triagem de AML, provedores de verificação de telefone e bancária e redes de Travel Rule, com as credenciais que cada um exige. |
| `didit_marketplace_list_connections` | Leitura | `didit:management` | `read:integrations` | As conexões do marketplace e as associações a redes da sua aplicação, com status e último uso. Os segredos nunca são retornados. |
| `didit_marketplace_request_integration` | Escrita | `didit:management` | `write:integrations` | Solicita uma integração que ainda não é self-service; a equipe da Didit fará o acompanhamento. |

***

## Organização, membros, faturamento e identidade visual

Duas ferramentas deste grupo (`didit_org_top_up`, `didit_org_reveal_application_api_key`) estão definidas no servidor, mas ficam ocultas no catálogo de todo chamador autenticado via OAuth; elas só aparecem em um servidor stdio local.

| Ferramenta | Tipo | Escopo | Permissão da função | O que faz |
| - | - | - | - | - |
| `didit_org_list` | Leitura | Qualquer um | — | As organizações às quais você pertence. |
| `didit_org_list_applications` | Leitura | Qualquer um | — | As aplicações de uma organização. |
| `didit_org_get_application` | Leitura | Qualquer um | — | Detalhes da aplicação, com a chave de API mascarada. |
| `didit_org_reveal_application_api_key` | Destrutiva | Qualquer um | — | Retorna a chave de API da aplicação sem mascaramento. Exige IDs explícitos e `confirm: true`. Oculta no conector hospedado. |
| `didit_org_get_balance` | Leitura | `didit:management` | `read:subscription` | Saldo de créditos e configurações de recarga automática. |
| `didit_org_top_up` | Destrutiva | Qualquer um | — | Cria um checkout do Stripe para adicionar créditos. Oculta no conector hospedado. |
| `didit_branding_get` | Leitura | `didit:management` | `read:customization` | A identidade visual (logotipos, cores) aplicada à sua interface de verificação. |
| `didit_branding_update` | Escrita | `didit:management` | `write:customization` | Envia novas imagens de identidade visual. |
| `didit_org_list_members` | Leitura | `didit:management` | `list:members` | Os membros de uma organização. |
| `didit_org_invite_member` | Escrita | `didit:management` | `write:members` | Convida um membro por e-mail com uma função. |
| `didit_org_update_member` | Escrita | `didit:management` | `write:members` | Altera a função de um membro. |
| `didit_org_remove_member` | Destrutiva | `didit:management` | `delete:members` | Remove um membro da organização. |
| `didit_org_list_roles` | Leitura | `didit:management` | `list:roles` | As funções disponíveis na organização. |
| `didit_org_list_api_keys` | Leitura | `didit:management` | `read:applications` | Metadados das chaves de API, com os valores brutos ocultados. |

***

## Entradas de arquivo

As ferramentas que recebem um arquivo (`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`) o aceitam em uma de duas formas:

* `*_base64`: o conteúdo do arquivo inline, como base64 bruto ou uma URL `data:`. Use esta forma com o endpoint hospedado.
* `*_path`: um caminho absoluto na máquina que executa o servidor. Só funciona em um servidor stdio local que compartilha o sistema de arquivos com você.

As duas formas impõem um limite de 15 MB e uma lista de permissões baseada em magic bytes (PNG, JPG, WebP, GIF, BMP, ICO, PDF). O transporte hospedado aceita corpos JSON de até 25 MB.

***

> [card] [Exemplos](https://docs.didit.me/pt-br/integration/mcp/examples.md)
>
> Conversas que usam essas ferramentas de ponta a ponta.

> [card] [Avançado](https://docs.didit.me/pt-br/integration/mcp/advanced.md)
>
> Funções, comportamento entre aplicações, fluxos com ramificações, webhooks, auto-hospedagem.


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