> ## 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, más herramientas genéricas de descubrimiento y de relay JSON para las operaciones 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](https://www.rfc-editor.org/rfc/rfc9457). 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. |