---
title: Strumenti
description: Riferimento dei 21 strumenti che il server MCP mette a disposizione di Claude Code, con i parametri principali. Utile per capire cosa succede dietro le quinte, non per usarli a mano.
---

Gli strumenti sono ciò che Claude usa per eseguire le tue richieste. In
Claude Code compaiono come `mcp__audin__<nome>` (li vedi con `/mcp`). Non
serve chiamarli direttamente: questa pagina è un riferimento per capire cosa
Claude può fare e con quali dati.

Tutti gli strumenti, tranne `list_accounts`, agiscono su **un account**: il
parametro `accountId` (dalla risposta di `list_accounts`) o, in alternativa,
l'account fissato con `AUDIN_DEFAULT_ACCOUNT_ID`.

## Account e pipeline

| Strumento | Cosa fa |
|---|---|
| `list_accounts` | Chi sei e su quali account puoi operare, con il ruolo. **Sempre per primo.** |
| `list_pipelines` | Le pipeline dei deal con gli stage (id, nome, iniziale/terminale). |

## Deal

| Strumento | Parametri principali | Cosa fa |
|---|---|---|
| `search_deals` | `query`, `status`, `pipelineId`, `stageId`, `ownerId`, `page` | Ricerca per titolo con filtri. Ritorna id, titolo, stage, contatto, aziende, preventivi e contratti collegati. |
| `get_deal` | `dealId` | Dettaglio completo: contatti, aziende, stage, prodotti con totali, preventivi e contratti con stato e link pubblico. |
| `create_deal` | `title`, `pipelineId`, `stageId?`, `amount?`, `primaryContactId?`, `contactIds?`, `companyIds?`, `expectedCloseDate?`, `description?` | Crea il deal. Senza stage parte da quello iniziale. |
| `add_deal_products` | `dealId`, `products[]` | Aggiunge righe dal listino (`productId`) o libere (`name` + prezzi). Le righe esistenti restano. |
| `remove_deal_product` | `dealId`, `lineId` | Rimuove una riga. |

Una **riga** (usata anche nelle offerte dei preventivi) ha: `productId` o
`name`, `description`, `quantity`, `unitLabel`, `oneTimePrice`,
`recurringPrice` con `billingPeriod` (`DAY`, `WEEK`, `MONTH`, `QUARTER`,
`YEAR`) e `billingPeriods`, `discountType` (`PERCENTAGE`, `FIXED_AMOUNT`) con
`discountValue`, `currency`.

## Contatti e aziende

| Strumento | Parametri principali | Cosa fa |
|---|---|---|
| `search_leads` | `query` | Cerca per nome, email o telefono. |
| `create_lead` | `fullName`, `email?`, `phoneNumber?`, `companyId?`, `role?` | Crea un contatto. |
| `search_companies` | `query` | Cerca per nome. |
| `create_company` | `name`, `domain`, `sector?`, `website?`, `city?`, … | Crea un'azienda. Il dominio è obbligatorio e unico per account. |

## Listino e clausole

| Strumento | Parametri principali | Cosa fa |
|---|---|---|
| `search_products` | `query?`, `categoryId?`, `includeInactive?` | Prodotti e servizi del listino con prezzi, periodo, unità. |
| `list_clauses` | `query?`, `category?` | Le clausole dell'account con il testo. Non vengono inserite automaticamente nei documenti. |

## Preventivi

| Strumento | Parametri principali | Cosa fa |
|---|---|---|
| `create_quote` | `dealId`, `title`, `htmlPath`, `offers[]?` | Carica l'HTML dal file (percorso assoluto) e crea le offerte con le righe, confermandole. Senza `offers` usa i prodotti del deal. |
| `update_quote_html` | `quoteId`, `htmlPath`, `documentReflectsOffers?` | Sostituisce l'HTML di una bozza. |
| `create_quote_revision` | `quoteId`, `htmlPath?`, `offers[]?` | Nuova revisione di un preventivo inviato: clona le offerte; con `offers` le rimpiazza, con `htmlPath` sostituisce il documento. |
| `send_quote` | `quoteId`, `expiresAt?`, `acknowledgeDrift?` | Attiva il link pubblico e lo restituisce. Non invia email. |
| `get_quote_pdf` | `quoteId`, `outputPath?` | Genera il PDF; con `outputPath` lo salva sul disco. |

Un'**offerta** ha `label`, `description?`, `isRecommended?`, `currency?` e
`lines[]` (le righe descritte sopra).

## Contratti

| Strumento | Parametri principali | Cosa fa |
|---|---|---|
| `create_contract` | `dealId`, `htmlPath`, `title?` | Crea il contratto dall'HTML. Un solo contratto in lavorazione per deal. |
| `send_contract` | `contractId`, `expiresAt?` | Genera il PDF se manca, attiva il link di firma e lo restituisce. |
| `get_contract_pdf` | `contractId`, `outputPath?` | PDF del contratto; se firmato, la versione firmata. |

## Cosa ricevono i risultati

Le risposte sono compatte: id, titoli, stati spiegati in italiano, totali e
link pubblici. **Mai** l'HTML dei documenti né il costo d'acquisto delle
righe. Gli errori dicono cosa fare: token da rifare, account da scegliere,
permesso mancante, conflitto da risolvere dalla dashboard.

## Variabili di configurazione

| Variabile | Obbligatoria | Default | Note |
|---|---|---|---|
| `AUDIN_PAT` | sì | — | Il token personale (`aud_pat_…`). |
| `AUDIN_DEFAULT_ACCOUNT_ID` | no | — | Account usato quando non lo indichi: comodo se ne hai uno solo. |
| `AUDIN_API_URL` | no | `https://api.audin.ai` | Solo per ambienti diversi da produzione. |
| `AUDIN_APP_URL` | no | `https://app.audin.ai` | Base dei link pubblici restituiti. |

Si passano al comando di registrazione con `--env NOME=valore`.