Herramientas MCP de Matcher

Las familias de herramientas que expone el servidor MCP de Matcher: herramientas curadas por categoría, además de herramientas genéricas de descubrimiento y un puente JSON para operaciones de Matcher.

El servidor MCP de Matcher expone una superficie de herramientas curada — herramientas ergonómicas y validadas para operaciones comunes — más un par de descubrimiento genérico y un puente JSON para operaciones indexadas. Las herramientas curadas siguen la convención de nombres family_action (por ejemplo, context_list o match_run_start), de modo que las herramientas relacionadas comparten un prefijo.

Esta página lista las familias con ejemplos representativos; deliberadamente no es un catálogo exhaustivo. Conecta un cliente y lista las herramientas disponibles para ver la superficie completa de tu versión.

​

Familias curadas

---

Categoría	Familias	Qué cubren	Herramientas representativas
Configuración	context_*, source_*, field_map_*	Contextos de reconciliación, sus fuentes de datos y los mapeos de campos que normalizan los registros entrantes.	context_create, context_setup_progress, source_list, field_map_update
Reglas de matching	match_rule_*	Las reglas de matching que aplica un contexto, incluido su orden de evaluación.	match_rule_create, match_rule_reorder
Tarifas	fee_schedule_*, fee_rule_*	Tablas de tarifas esperadas y las reglas asociadas a ellas, incluida la simulación antes de activarlas.	fee_schedule_simulate, fee_rule_create
Ejecuciones de reconciliación	match_run_*	Conducir la reconciliación — iniciar una ejecución, seguir su progreso, inspeccionar los grupos de match resultantes.	match_run_start, match_run_groups
Excepciones	exception_*	Trabajar transacciones sin conciliar — listado, historial y comentarios, acciones por excepción y operaciones masivas.	exception_list, exception_force_match, exception_bulk_resolve
Disputas	dispute_*	El ciclo de vida de las disputas para excepciones impugnadas.	dispute_submit_evidence, dispute_close
Ingesta	ingestion_*	El ciclo de vida de importación — cargar datos, inspeccionar trabajos y errores por fila, buscar e ignorar transacciones.	ingestion_upload, ingestion_job_errors_list
Reportes	dashboard_*, report_*	Agregados del panel y cortes enfocados, además de lecturas, conteos y exportaciones de reportes.	dashboard_match_rate, report_summary, report_export_unmatched

​

Trío genérico

---

Cuando una herramienta curada no cubra la operación que necesitas, usa las herramientas genéricas para inspeccionar el contrato de la API incorporado cuando se inicia el servidor y, cuando la operación acepte un cuerpo JSON (o no necesite cuerpo), invocarla:

Herramienta	Propósito
matcher_list_operations	Lista las operaciones del índice OpenAPI incorporado que se crea al iniciar el servidor MCP; puedes filtrar por etiqueta. No llama a Matcher ni requiere una credencial.
matcher_describe_operation	Describe una operación indexada — su método, ruta con plantillas, parámetros de ruta y consulta, resumen y, si existe, un esquema JSON desreferenciado del cuerpo de solicitud. No incluye esquemas de respuesta.
matcher_invoke	Ensambla, valida y despacha una operación indexada con parámetros de ruta/consulta y, cuando corresponde, un cuerpo de solicitud JSON, usando tus credenciales reenviadas.

matcher_invoke no admite cuerpos multipart ni binarios sin procesar. Usa una herramienta curada aplicable o llama directamente a la API HTTP de Matcher para esas operaciones. Las herramientas curadas y matcher_invoke comparten el mismo contrato de cliente HTTP, relay de token de cierre seguro y mapeo de errores RFC 9457. Ante fallos de la API de Matcher, ambas devuelven errores de herramienta estructurados que preservan el estado, título, detalle y código del problema.

​

Utilidades

---

Herramienta	Propósito
mcp_ping	Confirma que el servidor está accesible.
mcp_whoami	Informa de si llegó la credencial bearer de tu cliente — solo la presencia, nunca el valor; devuelve un error de herramienta cuando no hay ninguna.