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

# Lista metriche disponibili

> Esplora tutte le metriche finanziarie Syrto disponibili per tipo - usalo per scoprire gli slug delle metriche prima di chiamare syrto_get_company_metrics.

`syrto_list_available_metrics` restituisce un catalogo di tutte le metriche Syrto disponibili, opzionalmente filtrate per tipo. Usalo per scoprire gli slug delle metriche quando devi chiamare [`syrto_get_company_metrics`](/it/mcp/tools/company-metrics) per metriche non già coperte da [`syrto_get_company_analysis`](/it/mcp/tools/company-analysis).

<Tip>
  Per un'analisi finanziaria generale, chiama direttamente `syrto_get_company_analysis` - non serve cercare gli slug. Usa questo strumento solo quando hai bisogno di recuperare metriche specifiche (es. singole voci di bilancio) fuori dalle quattro categorie Syrto.
</Tip>

## Quando usare questo strumento

* Scoprire gli slug delle metriche disponibili per tipo
* Costruire set personalizzati di metriche e confermare i nomi degli slug corretti
* Esplorare tutte le metriche Syrto disponibili

**Strumenti correlati:** Per formule e definizioni delle metriche, usa [Definizioni metriche](/it/mcp/tools/metric-definitions). Per i valori effettivi delle metriche, usa [Metriche aziendali](/it/mcp/tools/company-metrics).

## Argomenti

<ParamField query="metric_type" type="string">
  Filtro opzionale. Uno tra: `"profitability"`, `"liquidity"`, `"solvency"`, `"structure"`, `"financial_ratio"`, `"balance_sheet_item"`, `"radar"`. Un tipo sconosciuto restituisce un errore che elenca quelli validi.
  Se omesso, restituisce un catalogo compatto di tutte le metriche raggruppate per tipo.
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

### Tipi di metriche

| Tipo | Cosa contiene |
| - | - |
| `balance_sheet_item` | Importi in euro tratti dal bilancio - voci di stato patrimoniale, conto economico e rendiconto finanziario, subtotali calcolati inclusi (ricavi, costi, EBT, flusso di cassa operativo, attivi, passivi) |
| `financial_ratio` | Altri rapporti, tassi e indici calcolati non nelle quattro categorie Syrto |
| `profitability` | Metriche di redditività - EBITDA, EBIT, ROE, ROA, margini, rendimenti |
| `liquidity` | Metriche di liquidità - capitale circolante, ciclo di conversione del contante, current ratio |
| `solvency` | Metriche di solvibilità - rapporti di debito, rapporti di copertura, leva finanziaria, sostenibilità finanziaria |
| `structure` | Metriche di struttura - composizione degli attivi, struttura del capitale, intensità degli investimenti |
| `radar` | Le due coordinate di posizionamento radar, dimensione ed efficienza, su scala 0-100 |

Gli assi dei grafici spider non sono tipi di metrica - leggili con [Grafici spider](/it/mcp/tools/spider-graphs).

## Risposta

<ResponseField name="total_metrics" type="integer">
  Numero totale di metriche su tutti i tipi.
</ResponseField>

<ResponseField name="categories" type="object[]">
  Lista di gruppi per tipo di metrica, ciascuno con:

  * `type` - nome della categoria di metriche
  * `count` - numero di metriche in questo gruppo
  * `metrics` - lista delle voci metriche

  **Modalità compatta** (senza `metric_type`): ogni metrica ha solo `slug` e `name`.

  **Modalità dettagliata** (con `metric_type`): ogni metrica include anche `description`, unità di misura, direzione `better_if` e `calculation_formula`.
</ResponseField>

<ResponseField name="calculation_formula" type="string">
  Solo in modalità dettagliata. La formula della metrica come **espressione matematica LaTeX** - per esempio `\frac{\text{Added value}}{\text{GDP}}`. Rendila come formula matematica dove il client lo consente, e mostrala insieme alla descrizione: è l'unico punto in cui è data la matematica.

  Nomina a parole le metriche che consuma, mai per slug, quindi è sicura da mostrare per intero. Assente per le metriche che sono voci grezze di bilancio anziché calcoli, e assente da ogni voce in modalità compatta.
</ResponseField>

Accanto a `result`, la risposta contiene i [campi restituiti da ogni strumento](/it/mcp/introduction#risposte). Su questo strumento `display_title` è sempre `Syrto AI` e `subtitle` non è valorizzato.

<Note>
  Lo `slug` è un identificativo interno. Usa il campo leggibile `name` per la visualizzazione.
</Note>

## Flusso di lavoro tipico

1. Chiama `syrto_list_available_metrics` con `metric_type="balance_sheet_item"` o `"financial_ratio"` per esplorare gli slug disponibili
2. Identifica gli slug rilevanti per la tua domanda
3. Passa quegli slug a [`syrto_get_company_metrics`](/it/mcp/tools/company-metrics)

## Esempio

**Ottenere i dettagli completi delle metriche di bilancio:**

```json theme={null}
{
  "metric_type": "balance_sheet_item"
}
```

**Risultato:**

* Restituisce tutte le metriche delle voci di bilancio con dettagli completi: nome, slug, descrizione, unità e direzione
* Scegli gli slug di cui hai bisogno (es. `revenues`, `total_assets`), poi passali a `syrto_get_company_metrics`


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