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. 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í
Sección titulada «Sigue por aquí»- La confirmación en escrituras — qué exige cada tool de “Tipo: Escritura” antes de llamar a la API.
- Conectar tu asistente — bloques de configuración por cliente.
- Referencia REST, en la sección API — el detalle completo de cada operación (parámetros, cuerpo, respuesta).