> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalogo strumenti

> Ventisette letture e diciotto modifiche per workspace, campagne e risposte inbox confermate esplicitamente.

| Tool | Scope | Effetto |
| - | - | - |
| `get_connection` | `workspaces:read` | Identità collegata, ambiente, scope e scadenza. |
| `list_workspaces` | `workspaces:read` | Una pagina dei workspace attualmente accessibili. |
| `get_workspace_capabilities` | `workspaces:read` | Permessi della richiesta e ruolo, senza concedere autorità di esecuzione. |
| `list_members` | `team:read` | Una pagina del team e il proprietario separato, senza identità tecniche. |
| `get_reply_routing` | `team:read` | Modalità di notifica e responsabili per canale, senza modifiche. |
| `list_senders` | `senders:read` | Metadati salvati e impedimenti locali, senza controlli live del provider. |
| `get_sender` | `senders:read` | Dettagli autorizzati del mittente, senza credenziali. |
| `find_contacts` | `contacts:read` | Ricerca esatta per email o una pagina di contatti. |
| `select_people` | `contacts:read` | Anteprima dell’idoneità locale tramite ID o filtri consentiti; è in sola lettura, richiede chiave di idempotenza e non iscrive i contatti. |
| `list_campaigns` | `campaigns:read` | Campagne salvate di un workspace e canale. |
| `get_campaign` | `campaigns:read` | Stato salvato, passaggi e percorso di revisione. |
| `get_campaign_configuration` | `campaigns:read` | Configurazione salvata e revisione; non approva i contenuti. |
| `configure_campaign` | `campaigns:read`, `campaigns:configure` | Configurazione inattiva con controllo revisione; questo strumento non attiva. |
| `create_campaign_draft` | `campaigns:write` | Crea una bozza inattiva; non avvia e non invia. |
| `pause_campaign` | `campaigns:read`, `campaigns:write` | Legge lo stato corrente e sospende le pianificazioni future. |
| `list_conversations` | `inbox:read` | Una pagina delle conversazioni salvate con risposte. |
| `get_conversation` | `inbox:read` | Messaggi salvati con provenienza e storico incompleto. |
| `get_reply_context` | `inbox:read` | Fino a 40 messaggi salvati con aggiornamento, completezza, stato mittente e revisione per rispondere; non aggiorna la cronologia provider. |
| `send_inbox_reply` | `inbox:send` | Accoda una risposta confermata esplicitamente usando mittente e thread originali; richiede revisione corrente esatta e chiave di idempotenza. Riconciliare gli esiti incerti senza ripetere automaticamente. |
| `get_workspace_report` | `analytics:read` | Totali storici registrati del workspace e canale. |
| `list_templates` | `templates:read` | Elenca i riepiloghi dei template email normali e intelligenti salvati. |
| `get_template` | `templates:read` | Legge i campi salvati del template e la revisione da usare nelle modifiche. |
| `create_template` | `templates:write` | Salva le impostazioni di un template normale o intelligente, senza generare o inviare email. |
| `update_template` | `templates:write` | Salva le modifiche richieste al template con controllo della revisione. |
| `import_linkedin_profiles` | `campaigns:import`, `campaigns:read` | Accoda la ricerca di 1-100 URL espliciti. Richiede la funzione disattivata per impostazione predefinita e può consumare quota provider; non avvia e non invia. |
| `get_operation` | `operations:read`, `campaigns:read` | Legge avanzamento ed esito sicuro di un’importazione o attivazione LinkedIn durevole. Richiede la funzione di esecuzione. |
| `list_operation_rows` | `operations:read`, `campaigns:read` | Legge gli esiti paginati di un’importazione. Richiede la funzione di esecuzione. |
| `cancel_operation` | `operations:write`, `campaigns:read`, grant originale del comando | Richiede `campaigns:import` per le importazioni o `campaigns:launch` per le attivazioni; annulla solo se il server conferma che è sicuro e non annulla attività già in corso. |
| `review_linkedin_campaign` | `campaigns:launch` | Crea una verifica locale a breve scadenza. Non verifica salute provider, quota o consegna e non attiva. Richiede la funzione di esecuzione. |
| `launch_linkedin_campaign` | `campaigns:launch` | Attiva esplicitamente una campagna LinkedIn manuale verificata per il dispatcher pianificato nativo. Richiede `confirm_launch=true` e la funzione; non avvia invii immediati né verifica la consegna. |
| `review_linkedin_resume` | `campaigns:launch` | Crea una verifica locale a breve scadenza per riprendere una campagna LinkedIn manuale già avviata e ora in pausa. Segnala tentativi con esito incerto e altri blocchi; non riprende la campagna. Richiede la funzione di esecuzione. |
| `resume_linkedin_campaign` | `campaigns:launch` | Riprende esplicitamente una campagna LinkedIn in pausa già verificata, affidandola allo scheduler periodico nativo. Richiede `confirm_resume=true` e la funzione; mantiene i progressi salvati e non ripete mai tentativi con esito incerto. |
| `get_linkedin_campaign_progress` | `campaigns:read` | Legge conteggi e timestamp salvati; l’attività salvata non prova la consegna. |
| `get_linkedin_prospect` | `campaigns:read` | Legge progressi salvati di un prospect in una campagna esplicita; non interroga il provider. |

## Input essenziali

Ogni operazione sul workspace richiede `workspace_id`. Campagne, inbox e report richiedono `channel`, con valore `email` o `linkedin`. Le liste partono da 25 record e accettano `limit` tra 1 e 100 e un `cursor` opaco. Tutti i 18 strumenti di modifica richiedono un `idempotency_key`.

Una bozza email accetta solo il nome. Le bozze LinkedIn supportano pubblico e passaggi esistenti. `pause_campaign` legge prima lo stato e non richiama attività già in corso. L’importazione LinkedIn accetta URL HTTPS espliciti per una bozza manuale inattiva idonea; non è una ricerca estesa e può consumare quota provider. L’importazione People mostra in anteprima CSV/XLSX e salva contatti senza iscriverli. Preparazione email, generazione con conferma dei crediti, approvazione del messaggio esatto, avvio verificato e risposta inbox confermata sono azioni separate. L’avvio email pianifica nelle finestre configurate, ma non verifica la consegna. Il contesto inbox può essere incompleto o non aggiornato e non recupera la cronologia provider. In caso di esito incerto, leggi l’operazione originale; non ripetere automaticamente. Consulta [esecuzione email](https://docs.emailx.ai/it/overview/email-execution.md), [risposte inbox](https://docs.emailx.ai/it/overview/inbox-replies.md), [importazione People](https://docs.emailx.ai/it/overview/people-import.md) e [verifica e avvio LinkedIn](https://docs.emailx.ai/it/overview/review-and-launch-linkedin.md). Ripresa, bozze di risposta, eliminazione e aggiornamento esteso della cronologia inbox restano non disponibili.

## Risultati tipizzati

Le chiamate riuscite restituiscono `data` e `meta` tipizzati, con ID richiesta, stato HTTP e indicazione di replay. Le liste mantengono la paginazione. Gli errori hanno `isError=true` e un oggetto `error`; non vengono presentati come successi. Le risposte sono limitate a 512 KiB e i campi API inattesi fanno fallire la validazione del contratto.

Scarica il [catalogo leggibile dalle macchine](https://app.emailx.ai/api/mcp-tools.json) per gli schemi esatti. Le annotazioni descrivono gli effetti, ma non sostituiscono l'autorizzazione dell'utente e i controlli correnti dell'API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.