# Herramientas · Convocatoria de ponencias

> Las 40 herramientas MCP de la convocatoria de ponencias, de principio a fin: las reglas del espacio, abrir y editar una convocatoria con itinerarios, días y banner, publicar, responsables y evaluadores, invitar ponentes, propuestas, evaluaciones y puntuaciones, decisión, contrapropuesta, confirmación en la agenda, votación y el lado de quien propone.

La [convocatoria de ponencias](/espacos/chamada-de-trabalhos) entera desde la conversación: abrir la convocatoria con las bases, los itinerarios y los días del evento, publicarla, formar el comité, seguir las evaluaciones, decidir, negociar las condiciones con el ponente y confirmar en la agenda. Quien propone también usa el asistente: enviar y editar la propuesta, responder a una contrapropuesta, votar.

Cada herramienta lleva un sello: <span class="tool-kind tool-kind-read">Solo consulta</span> no cambia nada, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia algo al momento, y <span class="tool-kind tool-kind-confirm">Pide confirmación</span> solo actúa después de tu sí a un resumen. Consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao).

## Quién usa qué

Las 40 herramientas aparecen para **todos los roles**, incluido el miembro: el responsable de una convocatoria puede ser un miembro cualquiera, y quien propone, evalúa o vota también. Memberfy comprueba cada convocatoria con la regla del propio módulo, como en la pantalla:

| Quién | Qué puede hacer |
|---|---|
| **Equipo** (propietario, administrador y moderador) o **responsable de la convocatoria** | Editar la convocatoria, los itinerarios, los días y los responsables; formar el comité; ver el avance; decidir, negociar y confirmar |
| **Quien puede abrir convocatorias** en el espacio | Abrir una convocatoria nueva. La regla es del espacio: solo los propietarios, el equipo o cualquier miembro ([`get_call_space_settings`](#get-call-space-settings)) |
| **Evaluador del itinerario** (que aceptó la invitación) | La cola de evaluación y la puntuación de cada propuesta del itinerario |
| **Quien la convocatoria deja votar** | La papeleta y el voto, dentro del periodo de votación |
| **Cualquier miembro** | Proponer en una convocatoria abierta, editar y retirar su propia propuesta, responder a una contrapropuesta |

Cuando el rol no lo permite, el asistente recibe el rechazo de Memberfy y lo explica.

## En resumen

### El espacio y las convocatorias

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`list_calls_for_papers`](#list-calls-for-papers) | Las convocatorias de un espacio, con su estado | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_call_space_settings`](#get-call-space-settings) | Cómo funciona el espacio: una convocatoria o varias, quién las abre | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`update_call_space_settings`](#update-call-space-settings) | Cambia el modo del espacio y quién puede abrir convocatorias | Administrador | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_call_for_papers`](#get-call-for-papers) | Una convocatoria con fechas, itinerarios, días, responsables y lo que puedes hacer en ella | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`create_call_for_papers`](#create-call-for-papers) | Abre una convocatoria en borrador, con itinerarios, días y banner | Quien puede abrir | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_for_papers`](#update-call-for-papers) | Edita texto, fechas, formatos, costes, caché e imágenes | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_status`](#update-call-status) | Publica, despublica, cierra o reabre | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_for_papers`](#delete-call-for-papers) | Elimina la convocatoria, con sus itinerarios y propuestas | Equipo o responsable | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |

### Itinerarios y días del evento

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`add_call_track`](#add-call-track) | Añade un itinerario | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_track`](#update-call-track) | Renombra un itinerario o cambia su propósito | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_track`](#delete-call-track) | Quita un itinerario | Equipo o responsable | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`add_call_event_date`](#add-call-event-date) | Añade un día al evento | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_event_date`](#update-call-event-date) | Cambia el horario de un día | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_event_date`](#delete-call-event-date) | Quita un día del evento | Equipo o responsable | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |

### Responsables, evaluadores y ponentes

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`add_call_owner`](#add-call-owner) | Invita a alguien a ser responsable de la convocatoria | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_call_owner`](#remove-call-owner) | Quita a un responsable | Equipo o responsable | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`list_track_reviewers`](#list-track-reviewers) | Los evaluadores de un itinerario | Equipo o responsable | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`invite_track_reviewer`](#invite-track-reviewer) | Pone a alguien como evaluador de un itinerario | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_track_reviewer`](#remove-track-reviewer) | Quita a un evaluador | Equipo o responsable | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`list_my_call_invitations`](#list-my-call-invitations) | Tus invitaciones pendientes, como responsable o evaluador | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`respond_to_call_invitation`](#respond-to-call-invitation) | Acepta o rechaza una invitación tuya | Cualquiera | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_speakers`](#list-speakers) | Quién ha propuesto ya en la comunidad | Equipo o responsable | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`invite_speaker`](#invite-speaker) | Invita a alguien a proponer | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |

### Evaluación, decisión y agenda

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`list_proposals`](#list-proposals) | Las propuestas, con estado, itinerario y puntuaciones | Según el rol en la convocatoria | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_proposal`](#get-proposal) | Una propuesta, con las evaluaciones y la negociación | Responsables, evaluadores del itinerario y quien la propuso | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`list_my_reviews`](#list-my-reviews) | Tu cola de evaluación | Evaluador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`review_proposal`](#review-proposal) | Puntúa una propuesta del 1 al 5 | Evaluador del itinerario | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_review_progress`](#get-review-progress) | El avance de la evaluación, frente al mínimo | Equipo o responsable | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`get_proposal_reviews`](#get-proposal-reviews) | Las puntuaciones de una propuesta y el consenso | Responsables; evaluadores después de evaluar | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`decide_proposal`](#decide-proposal) | Acepta o rechaza una propuesta | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`negotiate_proposal`](#negotiate-proposal) | Contrapropuesta, retirarla, aceptar o cerrar la negociación | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`confirm_proposal`](#confirm-proposal) | Confirma la propuesta aceptada en la agenda | Equipo o responsable | <span class="tool-kind tool-kind-write">Modifica</span> |

### Votación

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`list_votable_proposals`](#list-votable-proposals) | La papeleta: lo que puedes votar y tu voto | Quien puede votar | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`vote_on_proposal`](#vote-on-proposal) | Vota del 1 al 5, o retira el voto | Quien puede votar | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_vote_results`](#get-vote-results) | El resultado, hasta donde la convocatoria lo muestra | Según la convocatoria | <span class="tool-kind tool-kind-read">Solo consulta</span> |

### Quien propone

| Herramienta | Qué hace | Quién | Tipo |
|---|---|---|---|
| [`list_my_proposals`](#list-my-proposals) | Tus propuestas, con su estado | Cualquiera | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`submit_proposal`](#submit-proposal) | Envía una propuesta a una convocatoria abierta | Cualquier miembro | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_proposal`](#update-proposal) | Edita la propuesta en borrador y la envía | Quien la propuso | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`withdraw_proposal`](#withdraw-proposal) | Retira la propuesta de la convocatoria | Quien la propuso | <span class="tool-kind tool-kind-confirm">Pide confirmación</span> |
| [`respond_to_counter_offer`](#respond-to-counter-offer) | Acepta la contrapropuesta o responde con otra | Quien la propuso | <span class="tool-kind tool-kind-write">Modifica</span> |

## Los ids y los valores

- **Convocatoria** (`call`) y **espacio** (`space`): el id o el enlace copiado de la app. El enlace de una propuesta (`?proposal=`) también sirve como convocatoria.
- **Propuesta** (`proposal`): el id o el enlace con `?proposal=`.
- **Itinerario**, **día del evento**, **responsable** y **evaluador** (`track_id`, `date_id`, `owner_id`, `reviewer_id`): vienen de [`get_call_for_papers`](#get-call-for-papers). El `owner_id` es el id del vínculo en `owner_links`, no el id de la persona.
- **Persona** (`profile_id`): de `list_members` o de [`list_speakers`](#list-speakers).
- **Fechas y horas**: en la zona horaria de la comunidad. Fecha y hora como `2026-11-30T23:59`; solo la fecha como `2026-11-30`; solo la hora como `19:00`.
- **Formatos**: `talk` (charla), `lightning_talk`, `keynote`, `workshop` (taller), `tutorial`, `masterclass`, `panel` (mesa redonda), `roundtable`, `case_study`, `demo`, `poster` y `other`.
- **Estado de la convocatoria**: `draft` (borrador), `open` (abierta), `reviewing` (en evaluación), `deciding` (decidiendo), `closed` (cerrada) y `archived` (archivada).
- **Costes** (viaje, transporte, aparcamiento, alojamiento, comidas): `none` (nadie), `organizer` (la organización) o `speaker` (el ponente).

## `list_calls_for_papers`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Listar convocatorias.** Las convocatorias de un espacio de convocatorias, con su estado. *Rol mínimo: cualquiera; el borrador solo aparece para quien se ocupa de él.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `space` | id o enlace | Sí | El espacio de convocatorias |
| `status` | uno de los estados | No | Filtra por estado |

**Pídelo así:** *"¿Qué convocatorias están abiertas?"*

## `get_call_space_settings`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver reglas del espacio de convocatorias.** Si el espacio es **una convocatoria** o **varias**, quién puede abrir una convocatoria y si abrirla necesita aprobación. *Rol mínimo: cualquiera.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `space` | id o enlace | Sí | El espacio de convocatorias |

**Pídelo así:** *"¿Un miembro puede abrir una convocatoria en el espacio Charlas?"*

## `update_call_space_settings`

<span class="tool-kind tool-kind-write">Modifica</span>

**Cambiar reglas del espacio de convocatorias.** Cambia el modo del espacio y quién puede abrir convocatorias. *Rol mínimo: administrador.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `space` | id o enlace | Sí | |
| `mode` | `single`, `multi` | No | Una convocatoria o varias |
| `who_can_open_call` | `owners`, `staff`, `members` | No | Propietario y administrador; también los moderadores; o cualquier miembro |
| `require_approval_to_open` | sí o no | No | Una convocatoria nueva espera aprobación |

**Pídelo así:** *"Deja que los moderadores abran convocatorias en el espacio Charlas."*

**Notas:** cambia quién puede hacer qué al momento. Consulta [El espacio: una convocatoria o varias](/espacos/chamada-de-trabalhos#el-espacio-una-convocatoria-o-varias).

## `get_call_for_papers`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver convocatoria.** Todo lo que muestra la página de la convocatoria: estado, fechas, formatos, costes y caché, los itinerarios (con sus evaluadores), los días del evento y los responsables, además de lo que puedes hacer en ella. *Rol mínimo: cualquiera; el borrador, solo para quien se ocupa de él.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | También acepta el enlace de una propuesta |

**Devuelve:** la convocatoria y, para quien puede editarla, los vínculos de los responsables (`owner_links`), con los ids que pide [`remove_call_owner`](#remove-call-owner).

**Pídelo así:** *"Enséñame la convocatoria del Congreso 2027: ¿qué itinerarios tiene y quién evalúa cada uno?"*

## `create_call_for_papers`

<span class="tool-kind tool-kind-write">Modifica</span>

**Abrir convocatoria.** Abre una convocatoria en un espacio de convocatorias, **en borrador**. Quien la crea pasa a ser responsable de la convocatoria. *Rol: quien la regla del espacio deja abrir convocatorias.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `space` | id o enlace | Sí | El espacio de convocatorias (`list_spaces` con el módulo `call4papers`) |
| `title` | texto, de 3 a 255 | Sí | |
| `slug` | texto | No | La dirección; sin ella, sale del título |
| `description` | Markdown, hasta 20.000 | No | Las bases, en [Markdown](/mcp/ferramentas#texto-en-markdown) (o HTML) |
| `summary` | texto, hasta 1.000 | No | Una o dos líneas para las tarjetas y el feed |
| `type` | `simple`, `advanced` | No | Simple o avanzada. Consulta [El tipo de convocatoria](/espacos/chamada-de-trabalhos#el-tipo-de-convocatoria) |
| `modality` | `in_person`, `online`, `hybrid` | No | Presencial, online o híbrida |
| `submission_opens_at`, `submission_closes_at` | fecha y hora | No | El periodo para proponer |
| `review_opens_at`, `review_closes_at`, `results_announced_at` | fecha y hora | No | La evaluación y el anuncio |
| `voting_opens_at`, `voting_closes_at` | fecha y hora | No | El periodo de votación |
| `evaluation_mode` | `none`, `committee`, `community` | No | Sin evaluación, comité por itinerario o voto de la comunidad |
| `blind_review` | sí o no | No | El evaluador no ve quién propuso |
| `min_reviews_per_submission` | número, hasta 20 | No | Evaluaciones mínimas por propuesta |
| `max_submissions_per_speaker` | número, hasta 100 | No | Propuestas por persona |
| `vote_visibility` | `hidden`, `counts`, `full` | No | Lo que muestra el resultado de la votación |
| `who_can_vote` | `owners`, `staff`, `members` | No | |
| `allow_counter_offer`, `counter_offer_timeout_days` | sí o no; días | No | Solo en la avanzada: contrapropuesta y el plazo para responder |
| `allowed_formats` | lista de formatos | No | |
| `allowed_durations` | lista de minutos | No | Por ejemplo `[20, 40]` |
| `speaker_benefits` | lista de textos | No | Por ejemplo *Entrada*, *Cena con los ponentes* |
| `air_travel_cost`, `ground_transport_cost`, `parking_cost`, `accommodation_cost`, `meal_cost` | `none`, `organizer`, `speaker` | No | Quién paga cada coste |
| `speaker_fee_mode`, `speaker_fee_amount` | `none`, `fixed`, `speaker_defined`; importe | No | El caché: ninguno, fijo o indicado por quien propone |
| `tracks` | lista de `name`, `purpose` | No | Los itinerarios, de una vez (hasta 30). El propósito es la vara de medir de los evaluadores |
| `event_dates` | lista de `date`, `start_time`, `end_time` | No | Los días del evento (hasta 60) |
| `image_url` o `image_base64` | enlace o archivo | No | El banner (16:9) |
| `featured_image_url` | enlace | No | La imagen cuadrada (1:1) |
| `idempotency_key` | texto | No | Repetir con la misma clave no vuelve a crearla |

**Devuelve:** la convocatoria creada. Una imagen defectuosa no impide la creación; el motivo llega en `warnings`.

**Pídelo así:** *"Abre la convocatoria del Congreso 2027, presencial en São Paulo los días 12 y 13 de marzo, con los itinerarios Producto, Datos y Carrera. Propuestas hasta el 30/11. Pagamos alojamiento y comidas; el viaje corre a cargo del ponente. Déjala en borrador y enséñamela."*

**Notas:** la convocatoria nace en borrador; publícala con [`update_call_status`](#update-call-status). Después de crearla, la respuesta sugiere lo que falta: itinerarios, evaluadores, publicar. El caché se registra en el acuerdo; el pago se hace fuera de la plataforma.

## `update_call_for_papers`

<span class="tool-kind tool-kind-write">Modifica</span>

**Editar convocatoria.** Los mismos campos de [`create_call_for_papers`](#create-call-for-papers), salvo itinerarios y días, que tienen herramientas propias. Solo cambia lo que se envía. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| los campos de la convocatoria | | No | Título, texto, fechas, tipo, formatos, duraciones, costes, caché, votación, evaluación, banner e imagen cuadrada |

**Pídelo así:** *"Amplía el plazo de propuestas del Congreso 2027 hasta el 15/12."*

**Notas:** una convocatoria que ya tiene puntuaciones o negociación no vuelve de avanzada a simple.

## `update_call_status`

<span class="tool-kind tool-kind-write">Modifica</span>

**Publicar, cerrar o reabrir convocatoria.** Cambia el estado de una convocatoria. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `action` | `publish`, `unpublish`, `close`, `reopen`, `set_status` | Sí | Publicar, volver a borrador, cerrar, reabrir o poner un estado concreto |
| `status` | uno de los estados | Con `set_status` | |

**Pídelo así:** *"Publica la convocatoria del Congreso 2027."* · *"Cierra la convocatoria: el plazo ha terminado."*

## `delete_call_for_papers`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Eliminar convocatoria.** Elimina la convocatoria, con sus itinerarios y propuestas. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |

**Devuelve:** en la primera llamada, el resumen (título, estado, cuántas propuestas) y el código de confirmación.

## `add_call_track`

<span class="tool-kind tool-kind-write">Modifica</span>

**Añadir track a la convocatoria.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `name` | texto, hasta 255 | Sí | |
| `purpose` | texto, hasta 5.000 | Sí | Qué busca el itinerario y qué no busca: la vara de medir de los evaluadores |

**Pídelo así:** *"Añade el itinerario Datos, para casos reales de análisis e ingeniería de datos, sin tutoriales de herramientas."*

## `update_call_track`

<span class="tool-kind tool-kind-write">Modifica</span>

**Editar track.** Renombra un itinerario o cambia su propósito. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `track_id` | id | Sí | De `get_call_for_papers` |
| `name`, `purpose` | texto | No | |

## `delete_call_track`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Eliminar track.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `track_id` | id | Sí | De `get_call_for_papers` |

## `add_call_event_date`

<span class="tool-kind tool-kind-write">Modifica</span>

**Añadir día del evento.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `date` | fecha (`2027-03-12`) | Sí | |
| `start_time`, `end_time` | hora (`09:00`) | Sí | En la zona horaria de la comunidad |

## `update_call_event_date`

<span class="tool-kind tool-kind-write">Modifica</span>

**Cambiar horario del día del evento.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `date_id` | id | Sí | De `get_call_for_papers` |
| `start_time`, `end_time` | hora | No | Al menos uno |

## `delete_call_event_date`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Quitar día del evento.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `date_id` | id | Sí | De `get_call_for_papers` |

## `add_call_owner`

<span class="tool-kind tool-kind-write">Modifica</span>

**Invitar coorganizador de la convocatoria.** Invita a un miembro a compartir la convocatoria contigo: el responsable se ocupa de la convocatoria, de los itinerarios, de los evaluadores y de las decisiones. La persona acepta con [`respond_to_call_invitation`](#respond-to-call-invitation). *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `profile_id` | id | Sí | De `list_members` |

**Notas:** da poder sobre la convocatoria, y la persona recibe la invitación por correo.

## `remove_call_owner`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Quitar organizador de la convocatoria.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `owner_id` | id | Sí | El id en `owner_links` de `get_call_for_papers`, no el id de la persona |

## `list_track_reviewers`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Listar evaluadores del track.** Los evaluadores de un itinerario y si cada uno ha aceptado. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `track_id` | id | Sí | De `get_call_for_papers` |

## `invite_track_reviewer`

<span class="tool-kind tool-kind-write">Modifica</span>

**Añadir evaluador del track.** Pone a un miembro como evaluador de un itinerario: puntúa todas las propuestas de ese itinerario. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `track_id` | id | Sí | De `get_call_for_papers` |
| `profile_id` | id | Sí | De `list_members` |

**Pídelo así:** *"Pon a Ana y a Bruno como evaluadores del itinerario Datos."*

**Notas:** la persona se entera por correo, en la primera llamada.

## `remove_track_reviewer`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Quitar evaluador del track.** *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `reviewer_id` | id | Sí | El id en `trackReviewers` de `get_call_for_papers`, o de `list_track_reviewers` |

## `list_my_call_invitations`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Mis invitaciones en convocatorias.** Tus invitaciones pendientes para ser responsable de una convocatoria o evaluador de un itinerario. *Rol mínimo: cualquiera.*

Parámetros: ninguno.

**Pídelo así:** *"¿Tengo alguna invitación para evaluar propuestas?"*

## `respond_to_call_invitation`

<span class="tool-kind tool-kind-write">Modifica</span>

**Responder invitación de la convocatoria.** *Rol mínimo: cualquiera, sobre sus propias invitaciones.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `kind` | `owner`, `reviewer` | Sí | Invitación como responsable o como evaluador |
| `invitation_id` | id | Sí | De `list_my_call_invitations` |
| `answer` | `accept`, `decline` | Sí | |

**Notas:** aceptar una invitación de evaluador lleva a tu cola de evaluación ([`list_my_reviews`](#list-my-reviews)).

## `list_speakers`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Listar ponentes.** Todas las personas que ya han propuesto en la comunidad, agrupadas por persona, para volver a invitarlas. *Rol: equipo o responsable de una convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `space` | id o enlace | No | Solo quien propuso en un espacio de convocatorias |

## `invite_speaker`

<span class="tool-kind tool-kind-write">Modifica</span>

**Invitar ponente a proponer.** Invita a un miembro a enviar una propuesta a una convocatoria, con un mensaje opcional. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `profile_id` | id | Sí | De `list_speakers` o `list_members` |
| `message` | texto, hasta 2.000 | No | Va en el correo |

**Pídelo así:** *"Invita a quienes dieron charlas el año pasado a proponer de nuevo para el Congreso 2027."*

**Notas:** envía un correo en la primera llamada.

## `list_proposals`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Listar propuestas de una convocatoria.** Las propuestas, con estado, itinerario y puntuaciones. *Rol: lo que aparece depende de tu papel en la convocatoria: los responsables ven todas, el evaluador las de su itinerario, quien propuso las suyas.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |

**Pídelo así:** *"¿Qué propuestas del itinerario Producto tienen las mejores puntuaciones?"*

**Notas:** si hay propuestas esperando decisión, la respuesta sugiere decidir cada una.

## `get_proposal`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver propuesta.** El texto, el itinerario, el estado, las evaluaciones que puedes ver y las rondas de negociación. *Rol: los responsables de la convocatoria, los evaluadores del itinerario y quien la propuso.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace (con `?proposal=`) | Sí | |

## `list_my_reviews`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Mi cola de evaluación.** Las propuestas de los itinerarios que evalúas, con tu puntuación cuando ya la has dado. *Rol: quien evalúa.*

Parámetros: ninguno.

**Pídelo así:** *"¿Qué me queda por evaluar?"*

## `review_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Evaluar propuesta.** Puntúa una propuesta de un itinerario que evalúas. *Rol: evaluador del itinerario que aceptó la invitación.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `score` | del 1 al 5 | Sí | |
| `recommendation` | `accept`, `reject` | No | |
| `internal_notes` | texto | No | Solo los ven los evaluadores y los responsables; quien propuso, nunca |
| `comments_to_speaker` | texto | No | La devolución a quien propuso |
| `submit` | sí o no | No | Por defecto, sí. Con no, queda como borrador para cambiarla después; una vez enviada, la evaluación queda bloqueada |

**Pídelo así:** *"Dale un 4 a la propuesta de Ana, recomendando aceptarla: el tema es muy bueno, pero el guion necesita un caso real."*

**Notas:** solo dentro del periodo de evaluación, y nunca sobre la propia propuesta.

## `get_review_progress`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver avance de la evaluación.** Cuántas evaluaciones tiene cada propuesta y cada evaluador, frente al mínimo de la convocatoria. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |

**Pídelo así:** *"¿Quién del comité todavía no ha evaluado?"*

## `get_proposal_reviews`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver evaluaciones de la propuesta.** Cada puntuación y recomendación, y el consenso. *Rol: los responsables de la convocatoria; el evaluador, después de enviar la suya.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |

## `decide_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Aceptar o rechazar propuesta.** Con un mensaje opcional para quien la propuso. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace (con `?proposal=`) | Sí | |
| `decision` | `accept`, `reject` | Sí | |
| `message` | texto | No | Va en el correo, como la nota de la organización |

**Pídelo así:** *"Acepta la propuesta de Ana y agradécele el envío."*

**Notas:** la persona recibe un correo en la primera llamada, por eso el asistente confirma contigo la decisión y el mensaje antes. Después de aceptar, la respuesta sugiere confirmarla en la agenda. Consulta [Correos de la convocatoria de ponencias](/notificacoes/emails-da-chamada-de-trabalhos).

## `negotiate_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Negociar propuesta.** El lado de la organización en una negociación (convocatoria avanzada, con la contrapropuesta activada). *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `action` | `counter_offer`, `retract`, `accept`, `decline` | Sí | Hacer una contrapropuesta, retirar la que está abierta, aceptar la contrapropuesta del ponente o cerrar, rechazando la propuesta |
| `terms` | `format`, `duration_minutes`, `track_id`, `scheduled_at`, `delivery_mode`, los costes, `fee_amount` | No | Solo las condiciones que cambian |
| `message` | texto | No | |

**Pídelo así:** *"Proponle a Ana hacer el taller en 90 minutos en lugar de 3 horas, con el alojamiento a nuestra cuenta."*

**Notas:** cada paso envía un correo a quien propuso, en la primera llamada.

## `confirm_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Confirmar propuesta en la agenda.** El paso final de una propuesta aceptada, con la fecha y la hora si ya las hay. *Rol: equipo o responsable de la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `scheduled_at` | fecha y hora | No | En la zona horaria de la comunidad |

## `list_votable_proposals`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver papeleta de votación.** Las propuestas que puedes votar en una convocatoria con voto de la comunidad, y tu voto actual. *Rol: quien la convocatoria deja votar.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |

## `vote_on_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Votar propuesta.** Del 1 al 5, dentro del periodo de votación, o retira el voto. *Rol: quien la convocatoria deja votar.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `value` | del 1 al 5 | No | El voto |
| `remove` | sí o no | No | Retira tu voto |

## `get_vote_results`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Ver resultado de la votación.** Hasta donde la visibilidad de votos de la convocatoria deja ver. *Rol: según la convocatoria.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |

## `list_my_proposals`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Mis propuestas.** Tus propuestas en la comunidad, o en una convocatoria, con su estado. *Rol mínimo: cualquiera.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | No | Solo las de esta convocatoria |

## `submit_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Enviar propuesta.** Propone una sesión a una convocatoria abierta. La propuesta sale con el nombre de quien conectó el asistente. *Rol: cualquier miembro, mientras la convocatoria está abierta.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `call` | id o enlace | Sí | |
| `title` | texto, de 3 a 255 | Sí | |
| `description` | Markdown, hasta 20.000 | Sí | La propuesta, en [Markdown](/mcp/ferramentas#texto-en-markdown) |
| `format` | uno de los formatos | Sí | |
| `duration_minutes` | minutos | Sí | |
| `level` | `beginner`, `intermediate`, `advanced` | No | |
| `track` | id o nombre del itinerario | Cuando la convocatoria tiene itinerarios | |
| `delivery_mode` | `in_person`, `online`, `either` | En la convocatoria híbrida | |
| `format_other`, `language`, `target_audience`, `prerequisites`, `resources_needed` | texto | No | |
| `pitch_video_url`, `speaker_video_url` | enlace | No | |
| `requested_fee_amount` | importe | No | Cuando la convocatoria deja que quien propone indique su caché |
| `send` | sí o no | No | Por defecto, sí. Con no, queda en borrador para enviarla después |
| `idempotency_key` | texto | No | |

**Pídelo así:** *"Envía al Congreso 2027 mi charla 'Datos sin hoja de cálculo', 40 minutos, nivel intermedio, en el itinerario Datos."*

## `update_proposal`

<span class="tool-kind tool-kind-write">Modifica</span>

**Editar mi propuesta.** Cambia la propuesta mientras está en borrador, y la envía con `send`. Solo cambia lo que se envía. *Rol: quien la propuso.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| los campos de la propuesta | | No | Los mismos de `submit_proposal` |
| `send` | sí o no | No | Envía la propuesta |

## `withdraw_proposal`

<span class="tool-kind tool-kind-confirm">Pide confirmación</span>

**Retirar mi propuesta.** Con un mensaje opcional para la organización. *Rol: quien la propuso.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `message` | texto, hasta 2.000 | No | |

**Notas:** no se puede deshacer, por eso pide tu sí.

## `respond_to_counter_offer`

<span class="tool-kind tool-kind-write">Modifica</span>

**Responder contraoferta.** La respuesta de quien propuso a la contrapropuesta de la organización: aceptarla (la propuesta queda aceptada en esas condiciones) o responder con sus propias condiciones y un mensaje. *Rol: quien la propuso.*

| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `proposal` | id o enlace | Sí | |
| `answer` | `accept`, `counter` | Sí | |
| `terms` | las mismas condiciones de `negotiate_proposal` | No | Con `counter` |
| `message` | texto | No | |

**Notas:** compromete a quien propuso y avisa a la organización, en la primera llamada.

## Relacionados

- [Convocatoria de ponencias](/espacos/chamada-de-trabalhos)
- [Receta: crear una convocatoria de ponencias](/mcp/receitas#13-crear-una-convocatoria-de-ponencias)
- [Herramientas](/mcp/ferramentas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)
