# Ferramentas · Chamada de trabalhos

> As 40 ferramentas MCP da chamada de trabalhos, do começo ao fim: as regras do espaço, abrir e editar uma chamada com trilhas, dias e banner, publicar, donos e avaliadores, convidar palestrantes, propostas, avaliações e notas, decisão, contraproposta, confirmação na agenda, votação e o lado de quem propõe.

A [chamada de trabalhos](/espacos/chamada-de-trabalhos) inteira pela conversa: abrir a chamada com o edital, as trilhas e os dias do evento, publicar, montar o comitê, acompanhar as avaliações, decidir, negociar as condições com o palestrante e confirmar na agenda. Quem propõe também usa o assistente: enviar e editar a proposta, responder a uma contraproposta, votar.

Cada ferramenta traz um selo: <span class="tool-kind tool-kind-read">Só consulta</span> não muda nada, <span class="tool-kind tool-kind-write">Altera</span> cria ou muda algo na hora, e <span class="tool-kind tool-kind-confirm">Pede confirmação</span> só age depois do seu sim a um resumo. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

## Quem usa o quê

As 40 ferramentas aparecem para **todos os papéis**, inclusive o membro: o dono de uma chamada pode ser um membro comum, e quem propõe, avalia ou vota também. A Memberfy confere cada chamada pela regra do próprio módulo, como na tela:

| Quem | O que pode |
|---|---|
| **Equipe** (proprietário, administrador e moderador) ou **dono da chamada** | Editar a chamada, as trilhas, os dias e os donos; montar o comitê; ver o andamento; decidir, negociar e confirmar |
| **Quem pode abrir chamada** no espaço | Abrir uma chamada nova. A regra é do espaço: só os donos, a equipe ou qualquer membro ([`get_call_space_settings`](#get-call-space-settings)) |
| **Avaliador da trilha** (que aceitou o convite) | A fila de avaliação e a nota de cada proposta da trilha |
| **Quem a chamada deixa votar** | A cédula e o voto, na janela de votação |
| **Qualquer membro** | Propor numa chamada aberta, editar e retirar a própria proposta, responder a uma contraproposta |

Quando o papel não permite, o assistente recebe a recusa da Memberfy e explica.

## Em resumo

### O espaço e as chamadas

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`list_calls_for_papers`](#list-calls-for-papers) | As chamadas de um espaço, com status | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`get_call_space_settings`](#get-call-space-settings) | Como o espaço funciona: uma ou várias chamadas, quem abre | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`update_call_space_settings`](#update-call-space-settings) | Muda o modo do espaço e quem pode abrir chamada | Administrador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`get_call_for_papers`](#get-call-for-papers) | Uma chamada com datas, trilhas, dias, donos e o que você pode fazer | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`create_call_for_papers`](#create-call-for-papers) | Abre uma chamada em rascunho, com trilhas, dias e banner | Quem pode abrir | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_call_for_papers`](#update-call-for-papers) | Edita texto, datas, formatos, custos, cachê e imagens | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_call_status`](#update-call-status) | Publica, despublica, encerra ou reabre | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_call_for_papers`](#delete-call-for-papers) | Exclui a chamada, com trilhas e propostas | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |

### Trilhas e dias do evento

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`add_call_track`](#add-call-track) | Acrescenta uma trilha | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_call_track`](#update-call-track) | Renomeia uma trilha ou muda o propósito | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_call_track`](#delete-call-track) | Tira uma trilha | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`add_call_event_date`](#add-call-event-date) | Acrescenta um dia ao evento | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_call_event_date`](#update-call-event-date) | Muda o horário de um dia | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_call_event_date`](#delete-call-event-date) | Tira um dia do evento | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |

### Donos, avaliadores e palestrantes

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`add_call_owner`](#add-call-owner) | Convida alguém para ser dono da chamada | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`remove_call_owner`](#remove-call-owner) | Tira um dono | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`list_track_reviewers`](#list-track-reviewers) | Os avaliadores de uma trilha | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`invite_track_reviewer`](#invite-track-reviewer) | Põe alguém como avaliador de uma trilha | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`remove_track_reviewer`](#remove-track-reviewer) | Tira um avaliador | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`list_my_call_invitations`](#list-my-call-invitations) | Os seus convites pendentes, para dono ou avaliador | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`respond_to_call_invitation`](#respond-to-call-invitation) | Aceita ou recusa um convite seu | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> |
| [`list_speakers`](#list-speakers) | Quem já propôs na comunidade | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`invite_speaker`](#invite-speaker) | Convida alguém a propor | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |

### Avaliação, decisão e agenda

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`list_proposals`](#list-proposals) | As propostas, com status, trilha e notas | Conforme o papel na chamada | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`get_proposal`](#get-proposal) | Uma proposta, com as avaliações e a negociação | Donos, avaliadores da trilha e quem propôs | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`list_my_reviews`](#list-my-reviews) | A sua fila de avaliação | Avaliador | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`review_proposal`](#review-proposal) | Dá nota de 1 a 5 a uma proposta | Avaliador da trilha | <span class="tool-kind tool-kind-write">Altera</span> |
| [`get_review_progress`](#get-review-progress) | O andamento da avaliação, contra o mínimo | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`get_proposal_reviews`](#get-proposal-reviews) | As notas de uma proposta e o consenso | Donos; avaliadores depois de avaliar | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`decide_proposal`](#decide-proposal) | Aceita ou recusa uma proposta | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`negotiate_proposal`](#negotiate-proposal) | Contraproposta, retirar, aceitar ou encerrar a negociação | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |
| [`confirm_proposal`](#confirm-proposal) | Confirma a proposta aceita na agenda | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> |

### Votação

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`list_votable_proposals`](#list-votable-proposals) | A cédula: o que você pode votar e o seu voto | Quem pode votar | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`vote_on_proposal`](#vote-on-proposal) | Vota de 1 a 5, ou tira o voto | Quem pode votar | <span class="tool-kind tool-kind-write">Altera</span> |
| [`get_vote_results`](#get-vote-results) | O resultado, até onde a chamada mostra | Conforme a chamada | <span class="tool-kind tool-kind-read">Só consulta</span> |

### Quem propõe

| Ferramenta | O que faz | Quem | Tipo |
|---|---|---|---|
| [`list_my_proposals`](#list-my-proposals) | As suas propostas, com status | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`submit_proposal`](#submit-proposal) | Envia uma proposta a uma chamada aberta | Qualquer membro | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_proposal`](#update-proposal) | Edita a proposta em rascunho e envia | Quem propôs | <span class="tool-kind tool-kind-write">Altera</span> |
| [`withdraw_proposal`](#withdraw-proposal) | Retira a proposta da chamada | Quem propôs | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`respond_to_counter_offer`](#respond-to-counter-offer) | Aceita a contraproposta ou responde com outra | Quem propôs | <span class="tool-kind tool-kind-write">Altera</span> |

## Os ids e os valores

- **Chamada** (`call`) e **espaço** (`space`): o id ou o link copiado do app. O link de uma proposta (`?proposal=`) também serve como chamada.
- **Proposta** (`proposal`): o id ou o link com `?proposal=`.
- **Trilha**, **dia do evento**, **dono** e **avaliador** (`track_id`, `date_id`, `owner_id`, `reviewer_id`): vêm de [`get_call_for_papers`](#get-call-for-papers). O `owner_id` é o id da ligação em `owner_links`, não o id da pessoa.
- **Pessoa** (`profile_id`): de `list_members` ou de [`list_speakers`](#list-speakers).
- **Datas e horas**: no fuso da comunidade. Data e hora como `2026-11-30T23:59`; só a data como `2026-11-30`; só a hora como `19:00`.
- **Formatos**: `talk` (palestra), `lightning_talk`, `keynote`, `workshop`, `tutorial`, `masterclass`, `panel` (painel), `roundtable`, `case_study`, `demo`, `poster` e `other`.
- **Status da chamada**: `draft` (rascunho), `open` (aberta), `reviewing` (em avaliação), `deciding` (decidindo), `closed` (encerrada) e `archived` (arquivada).
- **Custos** (passagem, transporte, estacionamento, hospedagem, alimentação): `none` (ninguém), `organizer` (a organização) ou `speaker` (o palestrante).

## `list_calls_for_papers`

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

**Listar chamadas de trabalhos.** As chamadas de um espaço de chamadas, com status. *Papel mínimo: qualquer; o rascunho só aparece para quem cuida dele.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | O espaço de chamadas |
| `status` | um dos status | Não | Filtra por status |

**Peça assim:** *"Quais chamadas estão abertas?"*

## `get_call_space_settings`

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

**Ver regras do space de chamadas.** Se o espaço é **uma chamada** ou **várias**, quem pode abrir uma chamada e se abrir precisa de aprovação. *Papel mínimo: qualquer.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | O espaço de chamadas |

**Peça assim:** *"Um membro pode abrir chamada no espaço Palestras?"*

## `update_call_space_settings`

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

**Alterar regras do space de chamadas.** Muda o modo do espaço e quem pode abrir chamada. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | |
| `mode` | `single`, `multi` | Não | Uma chamada ou várias |
| `who_can_open_call` | `owners`, `staff`, `members` | Não | Proprietário e administrador; também os moderadores; ou qualquer membro |
| `require_approval_to_open` | sim ou não | Não | Uma chamada nova espera aprovação |

**Peça assim:** *"Deixe os moderadores abrirem chamadas no espaço Palestras."*

**Notas:** muda quem pode fazer o quê na hora. Ver [O espaço: uma chamada ou várias](/espacos/chamada-de-trabalhos#o-espaco-uma-chamada-ou-varias).

## `get_call_for_papers`

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

**Ver chamada de trabalhos.** Tudo o que a página da chamada mostra: status, datas, formatos, custos e cachê, as trilhas (com os avaliadores), os dias do evento e os donos, mais o que você pode fazer nela. *Papel mínimo: qualquer; o rascunho só para quem cuida dele.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | Também aceita o link de uma proposta |

**Devolve:** a chamada e, para quem pode editar, as ligações dos donos (`owner_links`), com os ids que [`remove_call_owner`](#remove-call-owner) pede.

**Peça assim:** *"Mostre a chamada do Congresso 2027: quais trilhas e quem avalia cada uma?"*

## `create_call_for_papers`

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

**Abrir chamada de trabalhos.** Abre uma chamada num espaço de chamadas, **em rascunho**. Quem cria vira dono da chamada. *Papel: quem a regra do espaço deixa abrir chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | O espaço de chamadas (`list_spaces` com o módulo `call4papers`) |
| `title` | texto, de 3 a 255 | Sim | |
| `slug` | texto | Não | O endereço; sem ele, vem do título |
| `description` | Markdown, até 20.000 | Não | O edital, em [Markdown](/mcp/ferramentas#texto-em-markdown) (ou HTML) |
| `summary` | texto, até 1.000 | Não | Uma ou duas linhas para os cards e o feed |
| `type` | `simple`, `advanced` | Não | Simples ou avançada. Ver [O tipo da chamada](/espacos/chamada-de-trabalhos#o-tipo-da-chamada) |
| `modality` | `in_person`, `online`, `hybrid` | Não | Presencial, online ou híbrida |
| `submission_opens_at`, `submission_closes_at` | data e hora | Não | O período para propor |
| `review_opens_at`, `review_closes_at`, `results_announced_at` | data e hora | Não | A avaliação e o anúncio |
| `voting_opens_at`, `voting_closes_at` | data e hora | Não | A janela de votação |
| `evaluation_mode` | `none`, `committee`, `community` | Não | Sem avaliação, comitê por trilha ou voto da comunidade |
| `blind_review` | sim ou não | Não | O avaliador não vê quem propôs |
| `min_reviews_per_submission` | número, até 20 | Não | Avaliações mínimas por proposta |
| `max_submissions_per_speaker` | número, até 100 | Não | Propostas por pessoa |
| `vote_visibility` | `hidden`, `counts`, `full` | Não | O que o resultado da votação mostra |
| `who_can_vote` | `owners`, `staff`, `members` | Não | |
| `allow_counter_offer`, `counter_offer_timeout_days` | sim ou não; dias | Não | Só na avançada: contraproposta e o prazo para responder |
| `allowed_formats` | lista de formatos | Não | |
| `allowed_durations` | lista de minutos | Não | Por exemplo `[20, 40]` |
| `speaker_benefits` | lista de textos | Não | Por exemplo *Ingresso*, *Jantar com os palestrantes* |
| `air_travel_cost`, `ground_transport_cost`, `parking_cost`, `accommodation_cost`, `meal_cost` | `none`, `organizer`, `speaker` | Não | Quem paga cada custo |
| `speaker_fee_mode`, `speaker_fee_amount` | `none`, `fixed`, `speaker_defined`; valor | Não | O cachê: nenhum, fixo ou informado por quem propõe |
| `tracks` | lista de `name`, `purpose` | Não | As trilhas, de uma vez (até 30). O propósito é a régua dos avaliadores |
| `event_dates` | lista de `date`, `start_time`, `end_time` | Não | Os dias do evento (até 60) |
| `image_url` ou `image_base64` | link ou arquivo | Não | O banner (16:9) |
| `featured_image_url` | link | Não | A imagem quadrada (1:1) |
| `idempotency_key` | texto | Não | Repetir com a mesma chave não cria de novo |

**Devolve:** a chamada criada. Uma imagem ruim não impede a criação; o motivo vem em `warnings`.

**Peça assim:** *"Abra a chamada do Congresso 2027, presencial em São Paulo nos dias 12 e 13 de março, com as trilhas Produto, Dados e Carreira. Propostas até 30/11. Pagamos hospedagem e alimentação; a passagem é do palestrante. Deixe em rascunho e me mostre."*

**Notas:** a chamada nasce em rascunho; publique com [`update_call_status`](#update-call-status). Depois de criar, a resposta sugere o que falta: trilhas, avaliadores, publicar. O cachê é registrado no acordo; o pagamento acontece fora da plataforma.

## `update_call_for_papers`

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

**Editar chamada de trabalhos.** Os mesmos campos de [`create_call_for_papers`](#create-call-for-papers), menos trilhas e dias, que têm ferramentas próprias. Só o que for enviado muda. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| os campos da chamada | | Não | Título, texto, datas, tipo, formatos, durações, custos, cachê, votação, avaliação, banner e imagem quadrada |

**Peça assim:** *"Estenda o prazo de propostas do Congresso 2027 até 15/12."*

**Notas:** uma chamada que já tem notas ou negociação não volta de avançada para simples.

## `update_call_status`

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

**Publicar, encerrar ou reabrir chamada.** Muda o status de uma chamada. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `action` | `publish`, `unpublish`, `close`, `reopen`, `set_status` | Sim | Publicar, voltar para rascunho, encerrar, reabrir ou pôr um status específico |
| `status` | um dos status | Com `set_status` | |

**Peça assim:** *"Publique a chamada do Congresso 2027."* · *"Encerre a chamada: o prazo acabou."*

## `delete_call_for_papers`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Excluir chamada de trabalhos.** Exclui a chamada, com as trilhas e as propostas. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |

**Devolve:** na primeira chamada, o resumo (título, status, quantas propostas) e o código de confirmação.

## `add_call_track`

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

**Adicionar trilha à chamada.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `name` | texto, até 255 | Sim | |
| `purpose` | texto, até 5.000 | Sim | O que a trilha procura e o que não procura: a régua dos avaliadores |

**Peça assim:** *"Acrescente a trilha Dados, para casos reais de análise e engenharia de dados, sem tutorial de ferramenta."*

## `update_call_track`

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

**Editar trilha.** Renomeia uma trilha ou muda o propósito. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `track_id` | id | Sim | De `get_call_for_papers` |
| `name`, `purpose` | texto | Não | |

## `delete_call_track`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Excluir trilha.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `track_id` | id | Sim | De `get_call_for_papers` |

## `add_call_event_date`

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

**Adicionar dia do evento.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `date` | data (`2027-03-12`) | Sim | |
| `start_time`, `end_time` | hora (`09:00`) | Sim | No fuso da comunidade |

## `update_call_event_date`

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

**Alterar horário do dia do evento.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `date_id` | id | Sim | De `get_call_for_papers` |
| `start_time`, `end_time` | hora | Não | Pelo menos um |

## `delete_call_event_date`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Remover dia do evento.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `date_id` | id | Sim | De `get_call_for_papers` |

## `add_call_owner`

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

**Convidar dono da chamada.** Convida um membro para dividir a chamada com você: o dono cuida da chamada, das trilhas, dos avaliadores e das decisões. A pessoa aceita com [`respond_to_call_invitation`](#respond-to-call-invitation). *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `profile_id` | id | Sim | De `list_members` |

**Notas:** dá poder sobre a chamada, e a pessoa recebe o convite por e-mail.

## `remove_call_owner`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Remover dono da chamada.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `owner_id` | id | Sim | O id em `owner_links` de `get_call_for_papers`, não o id da pessoa |

## `list_track_reviewers`

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

**Listar avaliadores da trilha.** Os avaliadores de uma trilha e se cada um aceitou. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `track_id` | id | Sim | De `get_call_for_papers` |

## `invite_track_reviewer`

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

**Adicionar avaliador da trilha.** Põe um membro como avaliador de uma trilha: ele dá nota a todas as propostas daquela trilha. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `track_id` | id | Sim | De `get_call_for_papers` |
| `profile_id` | id | Sim | De `list_members` |

**Peça assim:** *"Ponha a Ana e o Bruno como avaliadores da trilha Dados."*

**Notas:** a pessoa fica sabendo por e-mail, na primeira chamada.

## `remove_track_reviewer`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Remover avaliador da trilha.** *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `reviewer_id` | id | Sim | O id em `trackReviewers` de `get_call_for_papers`, ou de `list_track_reviewers` |

## `list_my_call_invitations`

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

**Meus convites em chamadas.** Os seus convites pendentes para ser dono de uma chamada ou avaliador de uma trilha. *Papel mínimo: qualquer.*

Parâmetros: nenhum.

**Peça assim:** *"Tenho algum convite para avaliar propostas?"*

## `respond_to_call_invitation`

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

**Responder convite da chamada.** *Papel mínimo: qualquer, sobre os próprios convites.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `kind` | `owner`, `reviewer` | Sim | Convite para dono ou para avaliador |
| `invitation_id` | id | Sim | De `list_my_call_invitations` |
| `answer` | `accept`, `decline` | Sim | |

**Notas:** aceitar um convite de avaliador leva à sua fila de avaliação ([`list_my_reviews`](#list-my-reviews)).

## `list_speakers`

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

**Listar palestrantes.** Todo mundo que já propôs na comunidade, agrupado por pessoa, para convidar de novo. *Papel: equipe ou dono de uma chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Não | Só quem propôs num espaço de chamadas |

## `invite_speaker`

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

**Convidar palestrante a propor.** Convida um membro a mandar proposta para uma chamada, com um recado opcional. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `profile_id` | id | Sim | De `list_speakers` ou `list_members` |
| `message` | texto, até 2.000 | Não | Vai no e-mail |

**Peça assim:** *"Convide quem palestrou no ano passado a propor de novo para o Congresso 2027."*

**Notas:** manda e-mail na primeira chamada.

## `list_proposals`

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

**Listar propostas de uma chamada.** As propostas, com status, trilha e notas. *Papel: o que aparece depende do seu papel na chamada: os donos veem todas, o avaliador as da trilha dele, quem propôs as próprias.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |

**Peça assim:** *"Quais propostas da trilha Produto têm as melhores notas?"*

**Notas:** com propostas esperando decisão, a resposta sugere decidir cada uma.

## `get_proposal`

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

**Ver proposta.** O texto, a trilha, o status, as avaliações que você pode ver e as rodadas de negociação. *Papel: os donos da chamada, os avaliadores da trilha e quem propôs.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link (com `?proposal=`) | Sim | |

## `list_my_reviews`

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

**Minha fila de avaliação.** As propostas das trilhas que você avalia, com a sua nota quando já deu. *Papel: quem avalia.*

Parâmetros: nenhum.

**Peça assim:** *"O que falta eu avaliar?"*

## `review_proposal`

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

**Avaliar proposta.** Dá a nota a uma proposta de uma trilha que você avalia. *Papel: avaliador da trilha que aceitou o convite.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `score` | de 1 a 5 | Sim | |
| `recommendation` | `accept`, `reject` | Não | |
| `internal_notes` | texto | Não | Só os avaliadores e os donos veem; quem propôs, nunca |
| `comments_to_speaker` | texto | Não | O retorno para quem propôs |
| `submit` | sim ou não | Não | Padrão sim. Com não, fica como rascunho para mudar depois; enviada, a avaliação fica travada |

**Peça assim:** *"Dê nota 4 à proposta da Ana, recomendando aceitar: o tema é ótimo, mas o roteiro precisa de um caso real."*

**Notas:** só dentro do período de avaliação, e nunca na própria proposta.

## `get_review_progress`

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

**Ver andamento da avaliação.** Quantas avaliações cada proposta e cada avaliador têm, contra o mínimo da chamada. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |

**Peça assim:** *"Quem do comitê ainda não avaliou?"*

## `get_proposal_reviews`

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

**Ver avaliações da proposta.** Cada nota e recomendação, e o consenso. *Papel: os donos da chamada; o avaliador, depois de mandar a dele.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |

## `decide_proposal`

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

**Aceitar ou recusar proposta.** Com uma mensagem opcional para quem propôs. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link (com `?proposal=`) | Sim | |
| `decision` | `accept`, `reject` | Sim | |
| `message` | texto | Não | Vai no e-mail, como o recado de quem organiza |

**Peça assim:** *"Aceite a proposta da Ana e agradeça pela submissão."*

**Notas:** a pessoa recebe e-mail na primeira chamada, por isso o assistente confirma com você a decisão e a mensagem antes. Depois de aceitar, a resposta sugere confirmar na agenda. Ver [E-mails da chamada de trabalhos](/notificacoes/emails-da-chamada-de-trabalhos).

## `negotiate_proposal`

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

**Negociar proposta.** O lado de quem organiza numa negociação (chamada avançada, com contraproposta ligada). *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `action` | `counter_offer`, `retract`, `accept`, `decline` | Sim | Fazer uma contraproposta, retirar a que está aberta, aceitar a contraproposta do palestrante ou encerrar, recusando a proposta |
| `terms` | `format`, `duration_minutes`, `track_id`, `scheduled_at`, `delivery_mode`, os custos, `fee_amount` | Não | Só as condições que mudam |
| `message` | texto | Não | |

**Peça assim:** *"Proponha à Ana fazer o workshop em 90 minutos em vez de 3 horas, com hospedagem por nossa conta."*

**Notas:** cada passo manda e-mail para quem propôs, na primeira chamada.

## `confirm_proposal`

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

**Confirmar proposta na agenda.** O passo final de uma proposta aceita, com a data e a hora se já houver. *Papel: equipe ou dono da chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `scheduled_at` | data e hora | Não | No fuso da comunidade |

## `list_votable_proposals`

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

**Ver cédula de votação.** As propostas que você pode votar numa chamada com voto da comunidade, e o seu voto atual. *Papel: quem a chamada deixa votar.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |

## `vote_on_proposal`

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

**Votar em proposta.** De 1 a 5, dentro da janela de votação, ou tira o voto. *Papel: quem a chamada deixa votar.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `value` | de 1 a 5 | Não | O voto |
| `remove` | sim ou não | Não | Tira o seu voto |

## `get_vote_results`

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

**Ver resultado da votação.** Até onde a visibilidade de votos da chamada deixa ver. *Papel: conforme a chamada.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |

## `list_my_proposals`

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

**Minhas propostas.** As suas propostas na comunidade, ou numa chamada, com status. *Papel mínimo: qualquer.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Não | Só as desta chamada |

## `submit_proposal`

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

**Enviar proposta.** Propõe uma sessão a uma chamada aberta. A proposta sai com o nome de quem conectou o assistente. *Papel: qualquer membro, enquanto a chamada está aberta.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `call` | id ou link | Sim | |
| `title` | texto, de 3 a 255 | Sim | |
| `description` | Markdown, até 20.000 | Sim | A proposta, em [Markdown](/mcp/ferramentas#texto-em-markdown) |
| `format` | um dos formatos | Sim | |
| `duration_minutes` | minutos | Sim | |
| `level` | `beginner`, `intermediate`, `advanced` | Não | |
| `track` | id ou nome da trilha | Quando a chamada tem trilhas | |
| `delivery_mode` | `in_person`, `online`, `either` | Na chamada híbrida | |
| `format_other`, `language`, `target_audience`, `prerequisites`, `resources_needed` | texto | Não | |
| `pitch_video_url`, `speaker_video_url` | link | Não | |
| `requested_fee_amount` | valor | Não | Quando a chamada deixa quem propõe dizer o cachê |
| `send` | sim ou não | Não | Padrão sim. Com não, fica em rascunho para enviar depois |
| `idempotency_key` | texto | Não | |

**Peça assim:** *"Mande para o Congresso 2027 a minha palestra 'Dados sem planilha', 40 minutos, nível intermediário, na trilha Dados."*

## `update_proposal`

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

**Editar minha proposta.** Muda a proposta enquanto ela está em rascunho, e envia com `send`. Só o que for enviado muda. *Papel: quem propôs.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| os campos da proposta | | Não | Os mesmos de `submit_proposal` |
| `send` | sim ou não | Não | Envia a proposta |

## `withdraw_proposal`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Retirar minha proposta.** Com um recado opcional para quem organiza. *Papel: quem propôs.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `message` | texto, até 2.000 | Não | |

**Notas:** não dá para desfazer, por isso pede o seu sim.

## `respond_to_counter_offer`

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

**Responder contraproposta.** A resposta de quem propôs à contraproposta da organização: aceitar (a proposta é aceita nessas condições) ou responder com as próprias condições e um recado. *Papel: quem propôs.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `proposal` | id ou link | Sim | |
| `answer` | `accept`, `counter` | Sim | |
| `terms` | as mesmas condições de `negotiate_proposal` | Não | Com `counter` |
| `message` | texto | Não | |

**Notas:** compromete quem propôs e avisa a organização, na primeira chamada.

## Relacionados

- [Chamada de trabalhos](/espacos/chamada-de-trabalhos)
- [Receita: criar um call for papers](/mcp/receitas#13-criar-um-call-for-papers)
- [Ferramentas](/mcp/ferramentas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)