Ferramentas MCP 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. 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.

Visão geral

Guias

Matcher UI

Servidor MCP

Operações

Ferramentas MCP do Matcher

Famílias curadas

Trio genérico

Utilitários

​Famílias curadas

​Trio genérico

​Utilitários

Famílias curadas

Trio genérico

Utilitários