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

# Matcher MCP tools

> The tool families the Matcher MCP server exposes — curated tools by category, plus a generic escape hatch over the full Matcher API.

The Matcher MCP server exposes a **curated** tool surface — one ergonomic, validated tool per common operation — plus a **generic trio** that can reach any operation in the Matcher API. Tools follow a `family_action` naming convention (for example, `context_list` or `match_run_start`), so related tools share a prefix.

This page lists the families with representative examples; it is deliberately not an exhaustive catalog. Connect a client and list the available tools to see the full surface for your version.

## Curated families

***

| Category                | Families                               | What they cover                                                                                             | Representative tools                                                          |
| ----------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| **Configuration**       | `context_*`, `source_*`, `field_map_*` | Reconciliation contexts, their data sources, and the field maps that normalize incoming records.            | `context_create`, `context_setup_progress`, `source_list`, `field_map_update` |
| **Matching rules**      | `match_rule_*`                         | The match rules a context applies, including their evaluation order.                                        | `match_rule_create`, `match_rule_reorder`                                     |
| **Fees**                | `fee_schedule_*`, `fee_rule_*`         | Expected-fee schedules and the rules attached to them, including simulation before rollout.                 | `fee_schedule_simulate`, `fee_rule_create`                                    |
| **Reconciliation runs** | `match_run_*`                          | Driving reconciliation — start a run, follow its progress, inspect the resulting match groups.              | `match_run_start`, `match_run_groups`                                         |
| **Exceptions**          | `exception_*`                          | Working unmatched transactions — listing, history and comments, per-exception actions, and bulk operations. | `exception_list`, `exception_force_match`, `exception_bulk_resolve`           |
| **Disputes**            | `dispute_*`                            | The dispute lifecycle for contested exceptions.                                                             | `dispute_submit_evidence`, `dispute_close`                                    |
| **Ingestion**           | `ingestion_*`                          | The import lifecycle — upload data, inspect jobs and per-row errors, search and ignore transactions.        | `ingestion_upload`, `ingestion_job_errors_list`                               |
| **Reporting**           | `dashboard_*`, `report_*`              | Dashboard aggregates and focused slices, plus report reads, counts, and exports.                            | `dashboard_match_rate`, `report_summary`, `report_export_unmatched`           |

## Generic trio

***

When a curated tool doesn't cover an operation, the generic trio reaches the entire Matcher API surface:

| Tool                         | Purpose                                                                       |
| ---------------------------- | ----------------------------------------------------------------------------- |
| `matcher_list_operations`    | List every operation the connected Matcher exposes.                           |
| `matcher_describe_operation` | Describe one operation — parameters, request body schema, and responses.      |
| `matcher_invoke`             | Assemble, validate, and dispatch any operation with your relayed credentials. |

Curated tools and `matcher_invoke` share one HTTP client and one token relay, so authorization and error mapping behave identically on both surfaces — Matcher errors come back as [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem details either way.

## Utilities

***

| Tool         | Purpose                                                                                  |
| ------------ | ---------------------------------------------------------------------------------------- |
| `mcp_ping`   | Confirm the server is reachable.                                                         |
| `mcp_whoami` | Report whether your client's bearer credential arrived — presence only, never the value. |