> ## 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 una vía de escape genérica sobre toda la API de Matcher.

El servidor MCP de Matcher expone una superficie de herramientas **curada** — una herramienta ergonómica y validada por operación común — más un **trío genérico** que alcanza cualquier operación de la API de Matcher. Las herramientas 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 cubre una operación, el trío genérico alcanza toda la superficie de la API de Matcher:

| Herramienta                  | Propósito                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| `matcher_list_operations`    | Lista todas las operaciones que expone el Matcher conectado.                         |
| `matcher_describe_operation` | Describe una operación — parámetros, esquema del cuerpo de la petición y respuestas. |
| `matcher_invoke`             | Ensambla, valida y despacha cualquier operación con tus credenciales reenviadas.     |

Las herramientas curadas y `matcher_invoke` comparten un único cliente HTTP y un único relay de token, así que la autorización y el mapeo de errores se comportan de forma idéntica en ambas superficies — los errores de Matcher vuelven como problem details [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) en los dos casos.

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