# Strumenti · Call for papers

> I 40 strumenti MCP della call for papers, dall'inizio alla fine: le regole dello spazio, aprire e modificare una call con track, giorni e banner, pubblicare, responsabili e revisori, invitare relatori, proposte, valutazioni e punteggi, decisione, controproposta, conferma nel programma, votazione e il lato di chi propone.

L'intera [call for papers](/espacos/chamada-de-trabalhos) dalla conversazione: aprire la call con il bando, i track e i giorni dell'evento, pubblicarla, formare il comitato, seguire le valutazioni, decidere, negoziare le condizioni con il relatore e confermare nel programma. Anche chi propone usa l'assistente: inviare e modificare la proposta, rispondere a una controproposta, votare.

Ogni strumento ha un'etichetta: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## Chi usa cosa

I 40 strumenti compaiono a **tutti i ruoli**, membro compreso: il responsabile di una call può essere un membro qualsiasi, e lo stesso vale per chi propone, valuta o vota. Memberfy controlla ogni call con la regola del modulo stesso, come sullo schermo:

| Chi | Cosa può fare |
|---|---|
| **Staff** (proprietario, Admin e moderatore) o **responsabile della call** | Modificare la call, i track, i giorni e i responsabili; formare il comitato; vedere l'avanzamento; decidere, negoziare e confermare |
| **Chi può aprire una call** nello spazio | Aprire una nuova call. La regola è dello spazio: solo i proprietari, lo staff o qualsiasi membro ([`get_call_space_settings`](#get-call-space-settings)) |
| **Revisore del track** (che ha accettato l'invito) | La coda di revisione e il punteggio di ogni proposta del track |
| **Chi la call lascia votare** | La scheda di voto e il voto, nella finestra di votazione |
| **Qualsiasi membro** | Proporre in una call aperta, modificare e ritirare la propria proposta, rispondere a una controproposta |

Quando il ruolo non lo consente, l'assistente riceve il rifiuto di Memberfy e lo spiega.

## In sintesi

### Lo spazio e le call

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`list_calls_for_papers`](#list-calls-for-papers) | Le call di uno spazio, con lo stato | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_call_space_settings`](#get-call-space-settings) | Come funziona lo spazio: una o più call, chi apre | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_call_space_settings`](#update-call-space-settings) | Cambia la modalità dello spazio e chi può aprire una call | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_call_for_papers`](#get-call-for-papers) | Una call con date, track, giorni, responsabili e ciò che puoi fare | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_call_for_papers`](#create-call-for-papers) | Apre una call in bozza, con track, giorni e banner | Chi può aprire | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_for_papers`](#update-call-for-papers) | Modifica testo, date, formati, costi, compenso e immagini | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_status`](#update-call-status) | Pubblica, riporta in bozza, chiude o riapre | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_for_papers`](#delete-call-for-papers) | Elimina la call, con track e proposte | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |

### Track e giorni dell'evento

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`add_call_track`](#add-call-track) | Aggiunge un track | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_track`](#update-call-track) | Rinomina un track o ne cambia lo scopo | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_track`](#delete-call-track) | Toglie un track | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`add_call_event_date`](#add-call-event-date) | Aggiunge un giorno all'evento | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_call_event_date`](#update-call-event-date) | Cambia l'orario di un giorno | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_call_event_date`](#delete-call-event-date) | Toglie un giorno dall'evento | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |

### Responsabili, revisori e relatori

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`add_call_owner`](#add-call-owner) | Invita qualcuno a diventare responsabile della call | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_call_owner`](#remove-call-owner) | Toglie un responsabile | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`list_track_reviewers`](#list-track-reviewers) | I revisori di un track | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`invite_track_reviewer`](#invite-track-reviewer) | Mette qualcuno come revisore di un track | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_track_reviewer`](#remove-track-reviewer) | Toglie un revisore | Staff o responsabile | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`list_my_call_invitations`](#list-my-call-invitations) | I tuoi inviti in sospeso, come responsabile o revisore | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`respond_to_call_invitation`](#respond-to-call-invitation) | Accetta o rifiuta un tuo invito | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_speakers`](#list-speakers) | Chi ha già proposto nella community | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`invite_speaker`](#invite-speaker) | Invita qualcuno a proporre | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |

### Valutazione, decisione e programma

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`list_proposals`](#list-proposals) | Le proposte, con stato, track e punteggi | Secondo il ruolo nella call | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_proposal`](#get-proposal) | Una proposta, con le valutazioni e la negoziazione | Responsabili, revisori del track e chi ha proposto | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_my_reviews`](#list-my-reviews) | La tua coda di revisione | Revisore | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`review_proposal`](#review-proposal) | Dà un punteggio da 1 a 5 a una proposta | Revisore del track | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_review_progress`](#get-review-progress) | L'avanzamento della valutazione, rispetto al minimo | Staff o responsabile | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_proposal_reviews`](#get-proposal-reviews) | I punteggi di una proposta e il consenso | Responsabili; revisori dopo aver valutato | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`decide_proposal`](#decide-proposal) | Accetta o rifiuta una proposta | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`negotiate_proposal`](#negotiate-proposal) | Controproposta, ritirare, accettare o chiudere la negoziazione | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`confirm_proposal`](#confirm-proposal) | Conferma nel programma la proposta accettata | Staff o responsabile | <span class="tool-kind tool-kind-write">Modifica</span> |

### Votazione

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`list_votable_proposals`](#list-votable-proposals) | La scheda di voto: cosa puoi votare e il tuo voto | Chi può votare | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`vote_on_proposal`](#vote-on-proposal) | Vota da 1 a 5, o toglie il voto | Chi può votare | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_vote_results`](#get-vote-results) | Il risultato, fin dove la call lo mostra | Secondo la call | <span class="tool-kind tool-kind-read">Solo lettura</span> |

### Chi propone

| Strumento | Cosa fa | Chi | Tipo |
|---|---|---|---|
| [`list_my_proposals`](#list-my-proposals) | Le tue proposte, con lo stato | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`submit_proposal`](#submit-proposal) | Invia una proposta a una call aperta | Qualsiasi membro | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_proposal`](#update-proposal) | Modifica la proposta in bozza e la invia | Chi ha proposto | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`withdraw_proposal`](#withdraw-proposal) | Ritira la proposta dalla call | Chi ha proposto | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`respond_to_counter_offer`](#respond-to-counter-offer) | Accetta la controproposta o risponde con un'altra | Chi ha proposto | <span class="tool-kind tool-kind-write">Modifica</span> |

## Gli id e i valori

- **Call** (`call`) e **spazio** (`space`): l'id o il link copiato dall'app. Anche il link di una proposta (`?proposal=`) vale come call.
- **Proposta** (`proposal`): l'id o il link con `?proposal=`.
- **Track**, **giorno dell'evento**, **responsabile** e **revisore** (`track_id`, `date_id`, `owner_id`, `reviewer_id`): arrivano da [`get_call_for_papers`](#get-call-for-papers). L'`owner_id` è l'id del collegamento in `owner_links`, non l'id della persona.
- **Persona** (`profile_id`): da `list_members` o da [`list_speakers`](#list-speakers).
- **Date e orari**: nel fuso orario della community. Data e ora come `2026-11-30T23:59`; solo la data come `2026-11-30`; solo l'ora come `19:00`.
- **Formati**: `talk`, `lightning_talk`, `keynote`, `workshop`, `tutorial`, `masterclass`, `panel`, `roundtable`, `case_study`, `demo`, `poster` e `other`.
- **Stati della call**: `draft` (bozza), `open` (aperta), `reviewing` (in valutazione), `deciding` (in decisione), `closed` (chiusa) e `archived` (archiviata).
- **Costi** (viaggio aereo, trasporto locale, parcheggio, alloggio, pasti): `none` (nessuno), `organizer` (l'organizzazione) o `speaker` (il relatore).

## `list_calls_for_papers`

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

**Elenca call for papers.** Le call di uno spazio call, con lo stato. *Ruolo minimo: qualsiasi; la bozza compare solo a chi la gestisce.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio call |
| `status` | uno degli stati | No | Filtra per stato |

**Chiedi così:** *"Quali call sono aperte?"*

## `get_call_space_settings`

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

**Vedi regole dello spazio call.** Se lo spazio è **Una call** o **Più call**, chi può aprire una call e se l'apertura richiede approvazione. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio call |

**Chiedi così:** *"Un membro può aprire una call nello spazio Talk?"*

## `update_call_space_settings`

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

**Cambia regole dello spazio call.** Cambia la modalità dello spazio e chi può aprire una call. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | |
| `mode` | `single`, `multi` | No | Una call o più call |
| `who_can_open_call` | `owners`, `staff`, `members` | No | Proprietario e Admin; anche i moderatori; oppure qualsiasi membro |
| `require_approval_to_open` | sì o no | No | Una nuova call attende l'approvazione |

**Chiedi così:** *"Lascia che i moderatori aprano call nello spazio Talk."*

**Note:** cambia subito chi può fare cosa. Vedi [Lo spazio: una call o più call](/espacos/chamada-de-trabalhos#lo-spazio-una-call-o-piu-call).

## `get_call_for_papers`

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

**Vedi call for papers.** Tutto ciò che mostra la pagina della call: stato, date, formati, costi e compenso, i track (con i revisori), i giorni dell'evento e i responsabili, più ciò che puoi fare. *Ruolo minimo: qualsiasi; la bozza solo per chi la gestisce.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | Accetta anche il link di una proposta |

**Restituisce:** la call e, per chi può modificarla, i collegamenti dei responsabili (`owner_links`), con gli id che chiede [`remove_call_owner`](#remove-call-owner).

**Chiedi così:** *"Mostrami la call del Congresso 2027: quali track ci sono e chi valuta ciascuno?"*

## `create_call_for_papers`

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

**Apri call for papers.** Apre una call in uno spazio call, **in bozza**. Chi la crea ne diventa responsabile. *Ruolo: chi la regola dello spazio lascia aprire una call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio call (`list_spaces` con il modulo `call4papers`) |
| `title` | testo, da 3 a 255 | Sì | |
| `slug` | testo | No | L'indirizzo; senza, viene dal titolo |
| `description` | Markdown, fino a 20.000 | No | Il bando, in [Markdown](/mcp/ferramentas#testo-in-markdown) (o HTML) |
| `summary` | testo, fino a 1.000 | No | Una o due righe per le card e il feed |
| `type` | `simple`, `advanced` | No | Semplice o avanzata. Vedi [Il tipo di call](/espacos/chamada-de-trabalhos#il-tipo-di-call) |
| `modality` | `in_person`, `online`, `hybrid` | No | Di persona, online o ibrida |
| `submission_opens_at`, `submission_closes_at` | data e ora | No | Il periodo per proporre |
| `review_opens_at`, `review_closes_at`, `results_announced_at` | data e ora | No | La valutazione e l'annuncio |
| `voting_opens_at`, `voting_closes_at` | data e ora | No | La finestra di votazione |
| `evaluation_mode` | `none`, `committee`, `community` | No | Senza valutazione, comitato per track o voto della community |
| `blind_review` | sì o no | No | Il revisore non vede chi ha proposto |
| `min_reviews_per_submission` | numero, fino a 20 | No | Valutazioni minime per proposta |
| `max_submissions_per_speaker` | numero, fino a 100 | No | Proposte per persona |
| `vote_visibility` | `hidden`, `counts`, `full` | No | Cosa mostra il risultato della votazione |
| `who_can_vote` | `owners`, `staff`, `members` | No | |
| `allow_counter_offer`, `counter_offer_timeout_days` | sì o no; giorni | No | Solo nell'avanzata: controproposta e il termine per rispondere |
| `allowed_formats` | elenco di formati | No | |
| `allowed_durations` | elenco di minuti | No | Per esempio `[20, 40]` |
| `speaker_benefits` | elenco di testi | No | Per esempio *Biglietto*, *Cena con i relatori* |
| `air_travel_cost`, `ground_transport_cost`, `parking_cost`, `accommodation_cost`, `meal_cost` | `none`, `organizer`, `speaker` | No | Chi paga ciascun costo |
| `speaker_fee_mode`, `speaker_fee_amount` | `none`, `fixed`, `speaker_defined`; importo | No | Il compenso: nessuno, fisso o indicato da chi propone |
| `tracks` | elenco di `name`, `purpose` | No | I track, in una volta (fino a 30). Lo scopo è il metro dei revisori |
| `event_dates` | elenco di `date`, `start_time`, `end_time` | No | I giorni dell'evento (fino a 60) |
| `image_url` o `image_base64` | link o file | No | Il banner (16:9) |
| `featured_image_url` | link | No | L'immagine quadrata (1:1) |
| `idempotency_key` | testo | No | Ripetere con la stessa chiave non crea di nuovo |

**Restituisce:** la call creata. Un'immagine non valida non impedisce la creazione; il motivo arriva in `warnings`.

**Chiedi così:** *"Apri la call del Congresso 2027, dal vivo a San Paolo il 12 e 13 marzo, con i track Prodotto, Dati e Carriera. Proposte entro il 30/11. Paghiamo alloggio e pasti; il viaggio è a carico del relatore. Lasciala in bozza e mostramela."*

**Note:** la call nasce in bozza; pubblicala con [`update_call_status`](#update-call-status). Dopo la creazione, la risposta suggerisce cosa manca: track, revisori, pubblicazione. Il compenso viene registrato nell'accordo; il pagamento avviene fuori dalla piattaforma.

## `update_call_for_papers`

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

**Modifica call for papers.** Gli stessi campi di [`create_call_for_papers`](#create-call-for-papers), tranne track e giorni, che hanno strumenti propri. Cambia solo ciò che viene inviato. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| i campi della call | | No | Titolo, testo, date, tipo, formati, durate, costi, compenso, votazione, valutazione, banner e immagine quadrata |

**Chiedi così:** *"Estendi la scadenza delle proposte del Congresso 2027 al 15/12."*

**Note:** una call che ha già punteggi o una negoziazione non torna da avanzata a semplice.

## `update_call_status`

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

**Pubblica, chiudi o riapri call.** Cambia lo stato di una call. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `action` | `publish`, `unpublish`, `close`, `reopen`, `set_status` | Sì | Pubblicare, tornare in bozza, chiudere, riaprire o impostare uno stato specifico |
| `status` | uno degli stati | Con `set_status` | |

**Chiedi così:** *"Pubblica la call del Congresso 2027."* · *"Chiudi la call: la scadenza è passata."*

## `delete_call_for_papers`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina call for papers.** Elimina la call, con i track e le proposte. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |

**Restituisce:** alla prima chiamata, il riepilogo (titolo, stato, quante proposte) e il codice di conferma.

## `add_call_track`

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

**Aggiungi track alla call.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `name` | testo, fino a 255 | Sì | |
| `purpose` | testo, fino a 5.000 | Sì | Cosa cerca il track e cosa non cerca: il metro dei revisori |

**Chiedi così:** *"Aggiungi il track Dati, per casi reali di analisi e ingegneria dei dati, niente tutorial sugli strumenti."*

## `update_call_track`

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

**Modifica track.** Rinomina un track o ne cambia lo scopo. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `track_id` | id | Sì | Da `get_call_for_papers` |
| `name`, `purpose` | testo | No | |

## `delete_call_track`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Elimina track.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `track_id` | id | Sì | Da `get_call_for_papers` |

## `add_call_event_date`

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

**Aggiungi giorno dell'evento.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `date` | data (`2027-03-12`) | Sì | |
| `start_time`, `end_time` | ora (`09:00`) | Sì | Nel fuso orario della community |

## `update_call_event_date`

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

**Cambia orario del giorno dell'evento.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `date_id` | id | Sì | Da `get_call_for_papers` |
| `start_time`, `end_time` | ora | No | Almeno uno dei due |

## `delete_call_event_date`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovi giorno dell'evento.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `date_id` | id | Sì | Da `get_call_for_papers` |

## `add_call_owner`

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

**Invita co-proprietario della call.** Invita un membro a condividere la call con te: il responsabile gestisce la call, i track, i revisori e le decisioni. La persona accetta con [`respond_to_call_invitation`](#respond-to-call-invitation). *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `profile_id` | id | Sì | Da `list_members` |

**Note:** dà potere sulla call, e la persona riceve l'invito per e-mail.

## `remove_call_owner`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovi proprietario della call.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `owner_id` | id | Sì | L'id in `owner_links` di `get_call_for_papers`, non l'id della persona |

## `list_track_reviewers`

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

**Elenca revisori del track.** I revisori di un track e se ciascuno ha accettato. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `track_id` | id | Sì | Da `get_call_for_papers` |

## `invite_track_reviewer`

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

**Aggiungi revisore del track.** Mette un membro come revisore di un track: assegna un punteggio a tutte le proposte di quel track. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `track_id` | id | Sì | Da `get_call_for_papers` |
| `profile_id` | id | Sì | Da `list_members` |

**Chiedi così:** *"Metti Ana e Bruno come revisori del track Dati."*

**Note:** la persona lo viene a sapere per e-mail, alla prima chiamata.

## `remove_track_reviewer`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovi revisore del track.** *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `reviewer_id` | id | Sì | L'id in `trackReviewers` di `get_call_for_papers`, oppure da `list_track_reviewers` |

## `list_my_call_invitations`

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

**I miei inviti nelle call.** I tuoi inviti in sospeso per diventare responsabile di una call o revisore di un track. *Ruolo minimo: qualsiasi.*

Parametri: nessuno.

**Chiedi così:** *"Ho qualche invito per valutare proposte?"*

## `respond_to_call_invitation`

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

**Rispondi all'invito della call.** *Ruolo minimo: qualsiasi, sui propri inviti.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `kind` | `owner`, `reviewer` | Sì | Invito come responsabile o come revisore |
| `invitation_id` | id | Sì | Da `list_my_call_invitations` |
| `answer` | `accept`, `decline` | Sì | |

**Note:** accettare un invito come revisore porta alla tua coda di revisione ([`list_my_reviews`](#list-my-reviews)).

## `list_speakers`

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

**Elenca relatori.** Tutti quelli che hanno già proposto nella community, raggruppati per persona, per invitarli di nuovo. *Ruolo: staff o responsabile di una call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | No | Solo chi ha proposto in uno spazio call |

## `invite_speaker`

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

**Invita relatore a proporre.** Invita un membro a inviare una proposta a una call, con un messaggio facoltativo. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `profile_id` | id | Sì | Da `list_speakers` o `list_members` |
| `message` | testo, fino a 2.000 | No | Va nell'e-mail |

**Chiedi così:** *"Invita chi ha parlato l'anno scorso a proporre di nuovo per il Congresso 2027."*

**Note:** invia un'e-mail alla prima chiamata.

## `list_proposals`

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

**Elenca le proposte di una call.** Le proposte, con stato, track e punteggi. *Ruolo: ciò che compare dipende dal tuo ruolo nella call: i responsabili le vedono tutte, il revisore quelle del suo track, chi ha proposto le proprie.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |

**Chiedi così:** *"Quali proposte del track Prodotto hanno i punteggi migliori?"*

**Note:** con proposte in attesa di decisione, la risposta suggerisce di decidere ciascuna.

## `get_proposal`

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

**Vedi proposta.** Il testo, il track, lo stato, le valutazioni che puoi vedere e i round di negoziazione. *Ruolo: i responsabili della call, i revisori del track e chi ha proposto.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link (con `?proposal=`) | Sì | |

## `list_my_reviews`

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

**La mia coda di revisione.** Le proposte dei track che valuti, con il tuo punteggio quando l'hai già dato. *Ruolo: chi valuta.*

Parametri: nessuno.

**Chiedi così:** *"Cosa mi resta da valutare?"*

## `review_proposal`

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

**Valuta proposta.** Dà il punteggio a una proposta di un track che valuti. *Ruolo: revisore del track che ha accettato l'invito.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `score` | da 1 a 5 | Sì | |
| `recommendation` | `accept`, `reject` | No | |
| `internal_notes` | testo | No | La vedono solo i revisori e i responsabili; chi ha proposto, mai |
| `comments_to_speaker` | testo | No | Il riscontro per chi ha proposto |
| `submit` | sì o no | No | Predefinito sì. Con no, resta in bozza da cambiare dopo; una volta inviata, la valutazione è bloccata |

**Chiedi così:** *"Dai 4 alla proposta di Ana, consigliando di accettarla: il tema è ottimo, ma la scaletta ha bisogno di un caso reale."*

**Note:** solo durante il periodo di valutazione, e mai sulla propria proposta.

## `get_review_progress`

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

**Vedi avanzamento della revisione.** Quante valutazioni hanno ogni proposta e ogni revisore, rispetto al minimo della call. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |

**Chiedi così:** *"Chi del comitato non ha ancora valutato?"*

## `get_proposal_reviews`

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

**Vedi revisioni della proposta.** Ogni punteggio e raccomandazione, e il consenso. *Ruolo: i responsabili della call; il revisore, dopo aver inviato la sua.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |

## `decide_proposal`

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

**Accetta o rifiuta proposta.** Con un messaggio facoltativo per chi ha proposto. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link (con `?proposal=`) | Sì | |
| `decision` | `accept`, `reject` | Sì | |
| `message` | testo | No | Va nell'e-mail, come il messaggio di chi organizza |

**Chiedi così:** *"Accetta la proposta di Ana e ringraziala per l'invio."*

**Note:** la persona riceve un'e-mail alla prima chiamata, per questo l'assistente conferma prima con te la decisione e il messaggio. Dopo l'accettazione, la risposta suggerisce di confermare nel programma. Vedi [Email della call for papers](/notificacoes/emails-da-chamada-de-trabalhos).

## `negotiate_proposal`

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

**Negozia proposta.** Il lato di chi organizza in una negoziazione (call avanzata, con la controproposta attiva). *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `action` | `counter_offer`, `retract`, `accept`, `decline` | Sì | Fare una controproposta, ritirare quella aperta, accettare la controproposta del relatore o chiudere, rifiutando la proposta |
| `terms` | `format`, `duration_minutes`, `track_id`, `scheduled_at`, `delivery_mode`, i costi, `fee_amount` | No | Solo le condizioni che cambiano |
| `message` | testo | No | |

**Chiedi così:** *"Proponi ad Ana di fare il workshop in 90 minuti invece di 3 ore, con l'alloggio a carico nostro."*

**Note:** ogni passo manda un'e-mail a chi ha proposto, alla prima chiamata.

## `confirm_proposal`

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

**Conferma proposta nel programma.** Il passo finale di una proposta accettata, con la data e l'ora se ci sono già. *Ruolo: staff o responsabile della call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `scheduled_at` | data e ora | No | Nel fuso orario della community |

## `list_votable_proposals`

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

**Vedi scheda di voto.** Le proposte che puoi votare in una call con voto della community, e il tuo voto attuale. *Ruolo: chi la call lascia votare.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |

## `vote_on_proposal`

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

**Vota proposta.** Da 1 a 5, nella finestra di votazione, oppure toglie il voto. *Ruolo: chi la call lascia votare.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `value` | da 1 a 5 | No | Il voto |
| `remove` | sì o no | No | Toglie il tuo voto |

## `get_vote_results`

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

**Vedi risultati del voto.** Fin dove la visibilità dei voti della call permette di vedere. *Ruolo: secondo la call.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |

## `list_my_proposals`

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

**Le mie proposte.** Le tue proposte nella community, o in una call, con lo stato. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | No | Solo quelle di questa call |

## `submit_proposal`

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

**Invia proposta.** Propone una sessione a una call aperta. La proposta esce con il nome di chi ha collegato l'assistente. *Ruolo: qualsiasi membro, finché la call è aperta.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `call` | id o link | Sì | |
| `title` | testo, da 3 a 255 | Sì | |
| `description` | Markdown, fino a 20.000 | Sì | La proposta, in [Markdown](/mcp/ferramentas#testo-in-markdown) |
| `format` | uno dei formati | Sì | |
| `duration_minutes` | minuti | Sì | |
| `level` | `beginner`, `intermediate`, `advanced` | No | |
| `track` | id o nome del track | Quando la call ha dei track | |
| `delivery_mode` | `in_person`, `online`, `either` | Nella call ibrida | |
| `format_other`, `language`, `target_audience`, `prerequisites`, `resources_needed` | testo | No | |
| `pitch_video_url`, `speaker_video_url` | link | No | |
| `requested_fee_amount` | importo | No | Quando la call lascia che sia chi propone a indicare il compenso |
| `send` | sì o no | No | Predefinito sì. Con no, resta in bozza da inviare dopo |
| `idempotency_key` | testo | No | |

**Chiedi così:** *"Invia al Congresso 2027 il mio talk 'Dati senza foglio di calcolo', 40 minuti, livello intermedio, nel track Dati."*

## `update_proposal`

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

**Modifica la mia proposta.** Cambia la proposta finché è in bozza, e la invia con `send`. Cambia solo ciò che viene inviato. *Ruolo: chi ha proposto.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| i campi della proposta | | No | Gli stessi di `submit_proposal` |
| `send` | sì o no | No | Invia la proposta |

## `withdraw_proposal`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Ritira la mia proposta.** Con un messaggio facoltativo per chi organizza. *Ruolo: chi ha proposto.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `message` | testo, fino a 2.000 | No | |

**Note:** non si può annullare, per questo chiede il tuo sì.

## `respond_to_counter_offer`

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

**Rispondi alla controproposta.** La risposta di chi ha proposto alla controproposta dell'organizzazione: accettare (la proposta viene accettata a quelle condizioni) oppure rispondere con le proprie condizioni e un messaggio. *Ruolo: chi ha proposto.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `proposal` | id o link | Sì | |
| `answer` | `accept`, `counter` | Sì | |
| `terms` | le stesse condizioni di `negotiate_proposal` | No | Con `counter` |
| `message` | testo | No | |

**Note:** impegna chi ha proposto e avvisa l'organizzazione, alla prima chiamata.

## Correlati

- [Call for papers](/espacos/chamada-de-trabalhos)
- [Ricetta: creare una call for papers](/mcp/receitas#13-creare-una-call-for-papers)
- [Strumenti](/mcp/ferramentas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)