Herramientas MCP de Matcher

El servidor MCP de Matcher expone una superficie de herramientas curada: herramientas ergonómicas y validadas para las operaciones comunes. También expone un par genérico de descubrimiento y un relay JSON para las operaciones indexadas. Las herramientas curadas siguen una convención de nombres family_action (por ejemplo, context_list o match_run_start), así las herramientas relacionadas comparten un prefijo. Esta página lista las familias con ejemplos representativos. 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_*`	Los contextos de conciliación, sus fuentes de datos y los mapas de campos que normalizan los registros entrantes.	`context_create`, `context_setup_progress`, `source_list`, `field_map_update`
Reglas de coincidencia	`match_rule_*`	Las reglas de coincidencia que aplica un contexto, incluido su orden de evaluación.	`match_rule_create`, `match_rule_reorder`
Comisiones	`fee_schedule_`, `fee_rule_`	Los esquemas de comisiones esperadas y las reglas asociadas a ellos, incluida la simulación antes del despliegue.	`fee_schedule_simulate`, `fee_rule_create`
Ejecuciones de conciliación	`match_run_*`	Conducir la conciliación — iniciar una ejecución, seguir su progreso, inspeccionar los grupos de coincidencia resultantes.	`match_run_start`, `match_run_groups`
Excepciones	`exception_*`	Trabajar las transacciones no conciliadas — 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 las excepciones impugnadas.	`dispute_submit_evidence`, `dispute_close`
Ingesta	`ingestion_*`	El ciclo de vida de la importación — subir datos, inspeccionar trabajos y errores por fila, buscar e ignorar transacciones.	`ingestion_upload`, `ingestion_job_errors_list`
Informes	`dashboard_`, `report_`	Agregados de dashboard y cortes específicos, más lecturas de informes, conteos y exportaciones.	`dashboard_match_rate`, `report_summary`, `report_export_unmatched`

Trío genérico

A veces una herramienta curada no cubre la operación que necesitas. Entonces usa las herramientas genéricas para inspeccionar el contrato de API que el servidor embebe al arrancar. Cuando la operación acepta un cuerpo JSON, o no necesita cuerpo, puedes invocarla:

Herramienta	Propósito
`matcher_list_operations`	Lista las operaciones del índice OpenAPI embebido que se construye cuando arranca el servidor MCP; de forma opcional, filtra por tag. No llama a Matcher ni requiere una credencial.
`matcher_describe_operation`	Describe una operación indexada — su método, la ruta con plantilla, los parámetros de ruta y de consulta, el resumen y, cuando existe, un esquema de cuerpo de solicitud JSON sin referencias. No incluye los esquemas de respuesta.
`matcher_invoke`	Arma, valida y despacha una operación indexada con parámetros de ruta y de consulta y, cuando corresponde, un cuerpo de solicitud JSON, con tus credenciales retransmitidas.

matcher_invoke no admite cuerpos multipart ni binarios en bruto. 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, la misma retransmisión de token que falla de forma cerrada y el mismo mapeo de errores de RFC 9457. Ante fallas de la API de Matcher, ambas devuelven errores de herramienta estructurados que preservan el status, el title, el detail y el code del problema.

Utilidades

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

Resumen

Guías

Matcher UI

Servidor MCP

Operaciones

Herramientas MCP de Matcher

Familias curadas

Trío genérico

Utilidades

​Familias curadas

​Trío genérico

​Utilidades

Familias curadas

Trío genérico

Utilidades