> ## 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 ferramentas genéricas de descoberta e de relay JSON para as operações do Matcher.

O servidor MCP do Matcher expõe uma superfície de ferramentas **curada**: ferramentas ergonômicas e validadas para operações comuns. Ele também expõe um **par genérico de descoberta** e um **relay JSON** para operações indexadas. As ferramentas curadas seguem a convenção de nome `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 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 conciliação, as fontes de dados deles e os mapas de campos que normalizam os registros recebidos.                    | `context_create`, `context_setup_progress`, `source_list`, `field_map_update` |
| **Regras de correspondência** | `match_rule_*`                         | As regras de correspondência que um contexto aplica, incluindo a ordem de avaliação delas.                                        | `match_rule_create`, `match_rule_reorder`                                     |
| **Tarifas**                   | `fee_schedule_*`, `fee_rule_*`         | Tabelas de tarifas esperadas e as regras anexadas a elas, incluindo a simulação antes do rollout.                                 | `fee_schedule_simulate`, `fee_rule_create`                                    |
| **Execuções de conciliação**  | `match_run_*`                          | Conduzir a conciliação — começar uma execução, acompanhar o progresso dela, inspecionar os grupos de correspondência 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 da disputa para exceções contestadas.                                                                             | `dispute_submit_evidence`, `dispute_close`                                    |
| **Ingestão**                  | `ingestion_*`                          | O ciclo de vida da 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 de dashboard e recortes focados, mais leituras, contagens e exportações de relatórios.                                  | `dashboard_match_rate`, `report_summary`, `report_export_unmatched`           |

## Trio genérico

***

Às vezes uma ferramenta curada não cobre a operação que você precisa. Então use as ferramentas genéricas para inspecionar o contrato da API que o servidor embute na inicialização. Quando a operação aceita um corpo JSON, ou não precisa de corpo, você pode invocá-la:

| Ferramenta                   | Finalidade                                                                                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `matcher_list_operations`    | Lista as operações do índice OpenAPI embutido, montado quando o servidor MCP sobe; opcionalmente filtra por tag. Não chama o Matcher nem exige credencial.                                                                      |
| `matcher_describe_operation` | Descreve uma operação indexada — o método dela, o caminho com template, os parâmetros de caminho e de query, o resumo e, quando existir, um schema de corpo de requisição JSON desreferenciado. Não inclui schemas de resposta. |
| `matcher_invoke`             | Monta, valida e despacha uma operação indexada com parâmetros de caminho e de query e, quando aplicável, um corpo de requisição JSON, usando as suas credenciais repassadas.                                                    |

`matcher_invoke` não aceita corpos multipart nem binários brutos. Para essas operações, use uma ferramenta curada aplicável ou chame a API HTTP do Matcher diretamente. As ferramentas curadas e `matcher_invoke` compartilham o mesmo contrato de cliente HTTP, o mesmo repasse de token fail-closed e o mesmo mapeamento de erros [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). Para falhas da API do Matcher, ambos retornam erros de ferramenta estruturados que preservam status, título, detalhe e código do problema.

## Utilitários

***

| Ferramenta   | Finalidade                                                                                                                                    |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `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; retorna um erro de ferramenta quando não há nenhuma. |