> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.
# PriceLabs MCP: catalogo completo (47 tool, 6 collegati)
> Inventario di tutti i tool esposti da mcp.pricelabs.co (verificato dal vivo il 28/09/2026), cosa è già collegato in Francesco AI/MCP team e cosa esiste ma non abbiamo ancora costruito.
**Pagina per il team, non per lo studente.** Cataloga capacità NON ancora costruite: non è una procedura da seguire, è la mappa per decidere cosa costruire dopo. Non finisce nel Supporto AI/Francesco AI (`DOCS_EXCLUDED`).
Verificato dal vivo il 28/09/2026 interrogando `tools/list` su `mcp.pricelabs.co` con un token OAuth reale (account Dimore di Sardegna, scope `read write customizations_write`). **47 tool esposti, 6 collegati** in `src/lib/pricelabs/ai-tools.ts` (Francesco AI) + `/api/team-mcp/pricelabs` (MCP team) — vedi [Collegamento](/integrazioni/pricelabs/collegamento) e [Revenue Management](/integrazioni/pricelabs/revenue-management).
## Già collegati (6)
`get_listings`, `get_listing_performance_metrics`, `get_listing_health_and_recommendations`, `diagnose_no_bookings` (lettura) · `update_listing_data`, `update_listing_date_overrides` (scrittura, un annuncio o lista di annunci — mai un gruppo intero).
## Strategia/personalizzazioni — ESISTE, non collegato
**Risposta diretta alla domanda "possiamo toccare la strategia generale, non solo i singoli prezzi": sì, PriceLabs lo espone, noi non l'abbiamo ancora costruito.**
* **`get_customizations`** / **`update_customizations`** — leggono/scrivono le personalizzazioni di pricing a **tre livelli**: `listing` (un annuncio), `group` (un gruppo intero), `account` (tutto l'account, per PMS/canale). Chiavi supportate: `seasonality`, `last_minute_prices`, `far_out_premium`, `day_of_week_adjustment`, `demand_factor`, `custom_seasonal_profile` — sono esattamente le "regole per stagioni, weekend, last-minute, far-future pricing" descritte in [Revenue Management](/integrazioni/pricelabs/revenue-management) come cose che oggi lo studente configura solo a mano dalla dashboard PriceLabs.
* **`get_customization_schema`** — lo schema di scrittura (nomi campo, tipi, range validi) per una o più customization: **da chiamare sempre prima di `update_customizations`**, invece di indovinare i campi. È "sempre aggiornato" (letto dalla spec pubblicata da PriceLabs), quindi è la fonte viva — non serve copiarne il contenuto qui.
* **`get_customization_profiles`** — i profili di stagionalità/pricing/min-stay/check-in salvati sull'account, con gli id che `custom_seasonal_profile` referenzia.
* Richiede lo scope OAuth di scrittura sul token dello studente (stesso controllo già fatto per `update_listing_data`); non risulta un requisito di scope diverso da `write` — `customizations_write`, che alcuni studenti (es. Dimore di Sardegna) hanno concesso in più durante l'OAuth, potrebbe essere un permesso extra che PriceLabs offre senza che i tool qui lo richiedano esplicitamente. Da verificare con un token che ha SOLO `write` senza `customizations_write`, se mai capita.
## Gruppo — ESISTE, non collegato
**Correzione a una risposta data prima stasera: esiste sì un'azione "di gruppo", non solo per singolo annuncio.**
* **`get_groups`** — i gruppi sull'account, con `group_id`.
* **`get_group_listings`** — gli annunci assegnati a un gruppo/sottogruppo.
* **`get_group_date_overrides`** / **`update_group_date_overrides`** / **`delete_group_date_overrides`** — override di prezzo per date future su **tutti gli annunci di un gruppo insieme**, stessi campi di `update_listing_date_overrides` (prezzo, min-stay, min/max, regole check-in) ma applicati in un colpo solo al gruppo intero. Questo è lo strumento giusto per un last-minute o una promozione su più annunci insieme, che oggi NON possiamo fare (solo un annuncio alla volta).
* `update_customizations` a `level="group"` copre anche le personalizzazioni di strategia per un gruppo intero.
## Altro, esiste ma non collegato (non approfondito stasera)
Organizzati per tema, dalla lista `tools/list` — nessuno di questi è stato letto in dettaglio, solo elencato:
* **Mercato/competitor**: `get_listing_neighborhood_market`, `get_neighbourhood_data`, `get_neighborhood_data_sources`, `set_neighborhood_data_source`, `get_md_report_compsets`, `market_research`, `get_str_index` — potrebbero coprire l'"Analisi della concorrenza" che oggi [Revenue Management](/integrazioni/pricelabs/revenue-management) descrive come servizio manuale del team nel modello delegato.
* **Ottimizzazione**: `get_listing_optimizer_summary`, `get_listing_optimizer_report`, `get_listing_optimizer_ranking` — suite più ampia di `get_listing_health_and_recommendations`, che è l'unico dei tre già collegato.
* **Reportistica**: `get_bookings_report`, `get_report_builder_templates`, `get_report_builder_data`, `poll_report_builder_data`, `get_account_review_report`, `get_user_logs`.
* **Dati grezzi**: `get_listing_data`, `get_listing_prices`, `get_listing_rate_plans`, `get_pms_reservations`, `get_listing_date_overrides` (singolo annuncio, letture più granulari di quelle già collegate).
* **Mappatura**: `map_listings`, `unmap_listings`.
* **Raccomandazioni**: `get_available_nudges`, `accept_nudge` — il sistema di "nudge" nativo di PriceLabs.
* **Servizio**: `get_me`, `pricelabs_feedback`, `pricelabs_help`, `get_knowledge`, `get_actions`, `refresh_listing_pricing`.
Prima di collegare uno qualunque di questi, rileggi la descrizione live del tool con `tools/list` (o `get_customization_schema` per le customizations): questa pagina fotografa lo stato del 28/09/2026, PriceLabs può cambiare i campi senza avvisare.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.