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

# Ferramentas MCP do Matcher

> As famílias de ferramentas que o servidor MCP do Matcher expõe — ferramentas curadas por categoria, mais uma válvula de escape genérica sobre toda a API do Matcher.

O servidor MCP do Matcher expõe uma superfície de ferramentas **curada** — uma ferramenta ergonômica e validada por operação comum — mais um **trio genérico** que alcança qualquer operação da API do Matcher. As ferramentas seguem a convenção de nomes `family_action` (por exemplo, `context_list` ou `match_run_start`), então ferramentas relacionadas compartilham um prefixo.

Esta página lista as famílias com exemplos representativos; ela deliberadamente não é um catálogo exaustivo. Conecte um cliente e liste as ferramentas disponíveis para ver a superfície completa da sua versão.

## Famílias curadas

***

| Categoria                      | Famílias                               | O que cobrem                                                                                                         | Ferramentas representativas                                                   |
| ------------------------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| **Configuração**               | `context_*`, `source_*`, `field_map_*` | Contextos de reconciliação, suas fontes de dados e os mapeamentos de campos que normalizam os registros recebidos.   | `context_create`, `context_setup_progress`, `source_list`, `field_map_update` |
| **Regras de matching**         | `match_rule_*`                         | As regras de matching que um contexto aplica, incluindo a ordem de avaliação.                                        | `match_rule_create`, `match_rule_reorder`                                     |
| **Tarifas**                    | `fee_schedule_*`, `fee_rule_*`         | Tabelas de tarifas esperadas e as regras associadas a elas, incluindo simulação antes da ativação.                   | `fee_schedule_simulate`, `fee_rule_create`                                    |
| **Execuções de reconciliação** | `match_run_*`                          | Conduzir a reconciliação — iniciar uma execução, acompanhar o progresso, inspecionar os grupos de match resultantes. | `match_run_start`, `match_run_groups`                                         |
| **Exceções**                   | `exception_*`                          | Trabalhar transações não conciliadas — listagem, histórico e comentários, ações por exceção e operações em lote.     | `exception_list`, `exception_force_match`, `exception_bulk_resolve`           |
| **Disputas**                   | `dispute_*`                            | O ciclo de vida de disputas para exceções contestadas.                                                               | `dispute_submit_evidence`, `dispute_close`                                    |
| **Ingestão**                   | `ingestion_*`                          | O ciclo de vida de importação — enviar dados, inspecionar jobs e erros por linha, buscar e ignorar transações.       | `ingestion_upload`, `ingestion_job_errors_list`                               |
| **Relatórios**                 | `dashboard_*`, `report_*`              | Agregados do dashboard e recortes focados, além de leituras, contagens e exportações de relatórios.                  | `dashboard_match_rate`, `report_summary`, `report_export_unmatched`           |

## Trio genérico

***

Quando uma ferramenta curada não cobre uma operação, o trio genérico alcança toda a superfície da API do Matcher:

| Ferramenta                   | Propósito                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------ |
| `matcher_list_operations`    | Lista todas as operações que o Matcher conectado expõe.                        |
| `matcher_describe_operation` | Descreve uma operação — parâmetros, schema do corpo da requisição e respostas. |
| `matcher_invoke`             | Monta, valida e despacha qualquer operação com as suas credenciais repassadas. |

As ferramentas curadas e o `matcher_invoke` compartilham um único cliente HTTP e um único relay de token, então autorização e mapeamento de erros se comportam de forma idêntica nas duas superfícies — os erros do Matcher voltam como problem details [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) em ambos os casos.

## Utilitários

***

| Ferramenta   | Propósito                                                                                |
| ------------ | ---------------------------------------------------------------------------------------- |
| `mcp_ping`   | Confirma que o servidor está acessível.                                                  |
| `mcp_whoami` | Informa se a credencial bearer do seu cliente chegou — apenas a presença, nunca o valor. |