<!--
  AUTO-GENERATED by scripts/generate-mcp-tools.mjs from openapi/public-v1.json — DO NOT EDIT BY HAND.
  To change this page: edit the intro/outro prose in that script, or refresh the fixture
  (openapi/README.md), then re-run "pnpm run generate:mcp-tools".
-->

Cada tool que expone el servidor MCP propio corresponde a **exactamente una** operación de la
API pública (`/public/v1`) — el servidor las genera al arrancar leyendo su definición OpenAPI, no
hay tools escritas a mano ni una lista que alguien pueda olvidar actualizar
(`SPEC_MCP_PROPIO.md` §2). Esta tabla se genera de la misma forma, a partir del mismo documento —
si un endpoint aparece o desaparece de la API, la tabla cambia sola en el siguiente build.

Las tools que ve tu cliente MCP en un momento dado son solo las que tu clave puede usar: el
servidor consulta `GET /public/v1/me` y filtra por los scopes efectivos de tu clave, la misma
lista de la guía **[Autenticación](/api/authentication/)**. `aymar_status` no aparece en la tabla
porque no viene de ningún endpoint del catálogo — es una tool propia del servidor MCP para
consultar tu tenant, plan y scopes efectivos, siempre visible.

| Recurso | Tool | Operación | Permiso necesario | Tipo |
| --- | --- | --- | --- | --- |
| Leads | `aymar_leads_create` | `POST /public/v1/leads` | `tenant:leads.manage` | Escritura |
| Leads | `aymar_leads_get` | `GET /public/v1/leads/{lead_id}` | `tenant:leads.read` | Lectura |
| Leads | `aymar_leads_list` | `GET /public/v1/leads` | `tenant:leads.read` | Lectura |
| Leads | `aymar_leads_update` | `PATCH /public/v1/leads/{lead_id}` | `tenant:leads.manage` | Escritura |
| Contactos | `aymar_contacts_create` | `POST /public/v1/contacts` | `tenant:contacts.manage` | Escritura |
| Contactos | `aymar_contacts_get` | `GET /public/v1/contacts/{contact_id}` | `tenant:contacts.read` | Lectura |
| Contactos | `aymar_contacts_list` | `GET /public/v1/contacts` | `tenant:contacts.read` | Lectura |
| Contactos | `aymar_contacts_update` | `PATCH /public/v1/contacts/{contact_id}` | `tenant:contacts.manage` | Escritura |
| Conversaciones | `aymar_conversations_get` | `GET /public/v1/conversations/{conversation_id}` | `tenant:conversations.read` | Lectura |
| Conversaciones | `aymar_conversations_list` | `GET /public/v1/conversations` | `tenant:conversations.read` | Lectura |
| Conversaciones | `aymar_conversations_list_messages` | `GET /public/v1/conversations/{conversation_id}/messages` | `tenant:conversations.read` | Lectura |
| Conversaciones | `aymar_conversations_send_message` | `POST /public/v1/conversations/{conversation_id}/messages` | `tenant:conversations.manage` | Escritura |
| Conversaciones | `aymar_conversations_start` | `POST /public/v1/conversations/start` | `tenant:conversations.manage` | Escritura |
| Citas | `aymar_appointments_create` | `POST /public/v1/appointments` | `tenant:appointments.manage` | Escritura |
| Citas | `aymar_appointments_get` | `GET /public/v1/appointments/{appointment_id}` | `tenant:appointments.read` | Lectura |
| Citas | `aymar_appointments_list` | `GET /public/v1/appointments` | `tenant:appointments.read` | Lectura |
| Citas | `aymar_appointments_update` | `PATCH /public/v1/appointments/{appointment_id}` | `tenant:appointments.manage` | Escritura |
| Citas | `aymar_availability_list` | `GET /public/v1/availability` | `tenant:appointments.read` | Lectura |
| Tickets | `aymar_tickets_add_comment` | `POST /public/v1/tickets/{ticket_id}/comments` | `tenant:tickets.manage` | Escritura |
| Tickets | `aymar_tickets_create` | `POST /public/v1/tickets` | `tenant:tickets.manage` | Escritura |
| Tickets | `aymar_tickets_get` | `GET /public/v1/tickets/{ticket_id}` | `tenant:tickets.read` | Lectura |
| Tickets | `aymar_tickets_list` | `GET /public/v1/tickets` | `tenant:tickets.read` | Lectura |
| Tickets | `aymar_tickets_update` | `PATCH /public/v1/tickets/{ticket_id}` | `tenant:tickets.manage` | Escritura |

## Sigue por aquí

- **[La confirmación en escrituras](/mcp/confirm/)** — qué exige cada tool de "Tipo: Escritura" antes de llamar a la API.
- **[Conectar tu asistente](/mcp/connect/)** — bloques de configuración por cliente.
- **Referencia REST**, en la sección **API** — el detalle completo de cada operación (parámetros, cuerpo, respuesta).