> ## 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.

# 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](https://www.rfc-editor.org/rfc/rfc9457). 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. |