MCP Reference: mapstools.googleapis.com

Questo è un server MCP fornito dai tool agentici di Maps Experience. Il server fornisce strumenti per gli sviluppatori per creare applicazioni LLM su Google Maps Platform.

Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione di AI. I server MCP connettono le applicazioni AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.

Configurazione del server

Prima di utilizzarli, devi attivare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.

Endpoint server

Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito un URL) del server MCP che un'applicazione di AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa.

Il server MCP dei tool agentici di Maps Experience ha il seguente endpoint MCP globale:

• https://mapstools.googleapis.com/mcp

Strumenti MCP

Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.

Strumenti

Il server MCP mapstools.googleapis.com dispone dei seguenti strumenti:

Strumenti MCP
search_places	Chiama questo strumento quando la richiesta dell'utente è trovare luoghi, attività, indirizzi, località, punti di interesse o qualsiasi altra ricerca correlata a Google Maps. Requisiti di input (FONDAMENTALI): text_query (stringa - OBBLIGATORIO): la query di ricerca principale. Deve definire chiaramente ciò che l'utente sta cercando. Esempi: 'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'. Per dettagli specifici sul luogo: includi l'attributo richiesto (ad es. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address'). location_bias (oggetto - FACOLTATIVO): utilizza questo parametro per dare la priorità ai risultati vicini a un'area geografica specifica. Formato: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}} Utilizzo: Per applicare un bias a un raggio di 5 km: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}} Per dare una forte priorità al punto centrale: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (omettendo radius_meters). language_code (stringa - FACOLTATIVO): la lingua in cui mostrare il riepilogo dei risultati di ricerca. Formato: un codice lingua di due lettere (ISO 639-1), facoltativamente seguito da un trattino basso e da un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio en, ja, en_US, zh_CN, es_MX. Se il codice lingua non viene fornito, i risultati saranno in inglese. region_code (stringa - FACOLTATIVO): il codice regione CLDR Unicode dell'utente. Questo parametro viene utilizzato per visualizzare i Place Details, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Formato: un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio US, CA. page_size (integer - FACOLTATIVO): il numero massimo di luoghi da restituire, da 1 a 10. Il valore predefinito è 5. Imposta un valore superiore a 5 solo quando l'utente vuole confrontare più di 5 luoghi; i valori da 6 a 10 comportano costi e latenza più elevati. include_extended_details (booleano - FACOLTATIVO): imposta questo campo su true quando la richiesta dell'utente richiede insight qualitativi dettagliati, dinamiche in tempo reale o attributi di entità specializzati. Il valore predefinito è false. L'impostazione di questo valore su true comporta costi e latenza più elevati. Instructions for Tool Call: Dati sulla posizione (CRITICO): la ricerca deve contenere dati sulla posizione sufficienti. Se la località è ambigua (ad es. solo "pizzerie"), devi specificarla nel parametro text_query (ad es. "pizzerie a New York") o utilizzare il parametro location_bias. Includi il nome della città, dello stato/della provincia e della regione/del paese, se necessario per evitare ambiguità. Fornisci sempre il text_query più specifico e ricco di contesto possibile. Utilizza location_bias solo se le coordinate vengono fornite esplicitamente o se è opportuno dedurre una posizione dal contesto noto di un utente e necessario per ottenere risultati migliori. L'output basato su dati reali deve essere attribuito alla fonte utilizzando le informazioni del campo attribution, se disponibili.
lookup_weather	Recupera informazioni ambientali complete per una località, tra cui meteo, qualità dell'aria (AQI e inquinanti) e polline (livelli di allergeni di alberi, erba, piante infestanti e specie vegetali): condizioni attuali, previsioni/cronologia orarie e previsioni giornaliere per meteo e qualità dell'aria; per il polline è disponibile solo una previsione giornaliera (da oggi a +4 giorni, nessun dato orario o passato). Available Environmental Domains & Capabilities (capabilities: WEATHER, AIR_QUALITY, POLLEN — CRITICAL): * Mandatory Explicit Selection: You MUST include at least one of WEATHER, AIR_QUALITY, or POLLEN in capabilities on every call. L'omissione di capabilities NON è consentita. * Query generiche/ambigue sull'outdoor (suite completa per l'outdoor): se l'utente pone una domanda generale sull'outdoor, sui viaggi o sulla situazione senza limitarsi a un dominio specifico (ad es. "Com'è il tempo fuori per una corsa?"), includi esplicitamente tutte e tre le funzionalità (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) per restituire la suite completa per l'outdoor (meteo + qualità dell'aria + polline); per un date/hour passato, ometti POLLEN, che non ha cronologia. * Selezione del dominio mirato (query specifiche): se l'utente chiede specificamente solo uno o due domini (ad es. "Qual è l'AQI a Seattle in questo momento?"), includi solo le funzionalità richieste (WEATHER, AIR_QUALITY e/o POLLEN). Verranno eseguiti e restituiti solo i domini richiesti. Dati specifici disponibili per dominio: * Meteo (weather): temperatura (attuale, percepita, massima/minima, indice di calore), vento (velocità, raffiche, direzione), eventi celesti (alba/tramonto, fase lunare), precipitazioni (tipo, probabilità, quantità/QPF) e condizioni atmosferiche (indice UV, umidità, copertura nuvolosa, probabilità di temporali, pressione atmosferica). * Qualità dell'aria (air_quality): indici di qualità dell'aria universali e locali (valore IQA, categoria, inquinante dominante), consigli per la salute in 7 gruppi di sensibilità e concentrazioni di inquinanti (include_pollutant_concentration: true). Ogni indice ha il proprio inquinante dominante; segnalalo per indice (ad es. non fornire l'inquinante dell'IQA universale per l'IQA degli Stati Uniti). * Polline (pollen): indice UPI (Universal Pollen Index, 0-5) giornaliero per le categorie Alberi, Erba ed Erbe infestanti e per specie di piante (index.value con il relativo index.category, ad esempio 1 = "Molto basso"), stato stagionale, reazioni crociate e consigli per la salute. * Campi dei pollini mancanti: un valore in_season mancante indica che non è stagione. Ometti le specie di piante restituite senza un index, a meno che l'utente non chieda informazioni su quella pianta; in questo caso, di' che oggi non sono stati segnalati dati sui pollini per quella pianta (non dedurre un livello). Regole per la località (CRITICO): la località target DEVE essere specificata in location utilizzando SOLO UNO dei seguenti campi secondari oneof: 1. Coordinate geografiche (lat_lng): * Utilizza questa opzione quando sono note le coordinate esatte di latitudine/longitudine. * Esempio: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. ID luogo (place_id): * Un ID luogo di Google Maps univoco (ad esempio, ottenuto da search_places o resolve_names). * Esempio: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Stringa dell'indirizzo (address): * Una città/regione, un quartiere, un punto di riferimento o un punto d'interesse, un indirizzo o un codice postale, idealmente con la città/il paese. * Esempio: {"location": {"address": "Paris, France"}} Modalità di ora e utilizzo (date e hour - CRITICO): * Riferimento al fuso orario locale: tutti gli input date ({year, month, day}) e hour (0-23) DEVONO essere espressi nel fuso orario civile locale della location richiesta (ad es. una query per "Paris tomorrow at 13:00" utilizza la data e l'ora locali di Europe/Paris 13), mai UTC o il fuso orario del chiamante. * 1. Current Conditions (date omitted AND hour omitted): * Provide location and the target capabilities (WEATHER, AIR_QUALITY, POLLEN). Do NOT specify date or hour. * Restituisce le condizioni attuali in tempo reale (CC) per i domini richiesti (meteo attuale, qualità dell'aria dell'ora corrente e/o previsioni dei pollini di oggi). * Per la qualità dell'aria, le condizioni attuali si riferiscono a una singola ora: NON utilizzarle da sole per rispondere a domande sulla qualità dell'aria o su domande generiche relative all'aria aperta per oggi nel suo complesso (utilizza le query giornaliere di seguito). * 2. Previsioni/cronologia orarie (date specificato E hour specificato 0-23): * Fornisci location, date ({year, month, day}), hour (0-23) e il target capabilities. Se vengono menzionati i minuti, arrotonda per difetto all'ora più vicina. * VINCOLO CRITICO (date è OBBLIGATORIO quando è impostato hour): l'invio di hour senza date (date omesso, hour impostato) NON è consentito e genererà un errore. Anche se l'utente chiede informazioni su un'ora specifica di oggi (ad es. "at 13:00 today"), DEVI compilare sia date (la data di oggi alle location) sia hour. * Esegue una ricerca oraria per il meteo e/o la qualità dell'aria richiesti alle ore YYYY-MM-DD-HH e una ricerca giornaliera per i pollini richiesti il giorno YYYY-MM-DD. * Domande sul meteo con "quando": per le domande sul meteo che chiedono quando/a che ora/il momento migliore (ad es. "what time will it stop raining?"), utilizza le chiamate WEATHER orarie (date + hour) per le ore pertinenti. Una previsione meteo giornaliera non ha valori orari. Per domande generiche sulle attività all'aperto con "quando/momento migliore" (ad es. "when is the best time to go walking today?"), effettua queste chiamate WEATHER orarie oltre alla chiamata per l'intera giornata per la qualità dell'aria (e il polline) descritta in Query giornaliere. * 3. Query giornaliere (date specificato E hour omesso): * Fornisci location, date ({year, month, day} nell'ora civile locale di location richiesta) senza hour e capabilities target per le query di un'intera giornata (ad es. "weather and pollen in London tomorrow"). * Domande sulla qualità dell'aria e domande generiche sull'outdoor relative a oggi: per le domande sulla qualità dell'aria e le domande generiche sull'outdoor (che includono la qualità dell'aria) relative a oggi (ad es. "how will the air quality change today", "is today a good day for a picnic?"), imposta date sulla data odierna alle ore location (ora omessa) per ottenere la serie oraria della qualità dell'aria del giorno. Una chiamata Current Conditions da sola restituisce solo l'ora corrente della qualità dell'aria e non è sufficiente; puoi aggiungerne una se l'utente chiede anche informazioni su "ora". * Finestre temporali della qualità dell'aria: per una domanda sulla qualità dell'aria relativa a una finestra temporale di un giorno (ad es. "air quality between noon and 6 PM"), preferisci una chiamata giornaliera per quella data e leggi le ore della finestra temporale dalla serie della qualità dell'aria, anziché campionare le singole ore. Se utilizzi le chiamate orarie, copri ogni ora della finestra. * Restituisce le previsioni giornaliere per Meteo e/o Polline richiesti e le serie orarie di Qualità dell'aria del giorno che coprono l'intera giornata locale (00:00-23:00 ora locale): 24 ore storiche per una data passata, 24 ore previste per una data futura e per oggi le ore precedenti (cronologia), l'ora corrente e le ore rimanenti (previsione). Orizzonti temporali supportati per dominio: * Meteo: ogni ora dalle 24 ore precedenti fino alle 240 ore (10 giorni) successive (le ore precedenti richiedono sia date che hour); ogni giorno fino a 10 giorni, incluso oggi (da oggi a +9 giorni); nessuna cronologia giornaliera. * Qualità dell'aria: ogni ora da 720 ore (30 giorni) fa fino a 96 ore (4 giorni) in avanti; una chiamata per l'intera giornata deve rientrare in questa finestra (in pratica oggi da -29 giorni a +3 giorni). * Polline: solo giornaliero, da oggi a +4 giorni (5 giorni incluso oggi); nessuna data passata e hour viene ignorato. * (Nota: se vengono richieste più funzionalità e date/hour non rientra in uno dei relativi intervalli, la chiamata viene comunque eseguita correttamente e restituisce solo quelle supportate.) * Richieste fuori intervallo: se una data o un'ora richiesta potrebbe non rientrare nell'intervallo supportato di un dominio (ad esempio, Pollen per una data passata), chiama comunque lookup_weather per la data/ora richiesta; lo stato di errore indica l'intervallo supportato. Non chiamare una data, un'ora o un dominio diversi come sostituti. Opzioni di dominio e attribuzione: * Lingua (language_code): codice lingua BCP-47 facoltativo (ad es. "fr"). Il valore predefinito è "en". * Unità meteo (weather_options.units_system o units_system): il valore predefinito è METRIC. Imposta su IMPERIAL (Fahrenheit/mph) se l'utente fa riferimento agli standard statunitensi o richiede esplicitamente le unità imperiali. Supportato sia in weather_options.units_system (preferito) sia in units_system di primo livello; se vengono specificati entrambi, non devono essere in conflitto. * Opzioni di qualità dell'aria (air_quality_options): imposta include_pollutant_concentration: true quando sono necessarie concentrazioni di inquinanti specifiche (PM2.5, PM10, O3, NO2, SO2, CO); facoltativamente imposta index_region_code (codice paese ISO di 2 lettere, ad es. "US") per richiedere una scala AQI regionale specifica. Per impostazione predefinita, la risposta include l'IQA universale e l'IQA regionale della località. * Attribuzione: l'output basato su dati reali DEVE essere attribuito alla fonte utilizzando il campo attribution all'interno di ogni container di dominio restituito (weather.attribution, air_quality.attribution, pollen.attribution). * Orari restituiti: i valori date_time della qualità dell'aria sono già nell'ora locale della località (utc_offset incluso); presentali così come sono. I valori date_time del meteo (corrente e orario) e gli orari di alba/tramonto sono in formato UTC; convertili nell'ora locale della località utilizzando time_zone. Etichetta tutti gli orari come locali.
compute_routes	Calcola i percorsi di viaggio tra un'origine e una destinazione, facoltativamente attraverso fermate intermedie. Restituisce la distanza e la durata di ogni percorso. Requisiti di input (FONDAMENTALI): origin e destination (oggetti - OBBLIGATORI): ciascuno deve essere fornito utilizzando esattamente uno dei seguenti elementi: address (stringa, ad es. 'Eiffel Tower, Paris'). I luoghi, i punti di riferimento e le attività con un nome vengono risolti direttamente, quindi NON chiamare prima search_places solo per geocodificare un waypoint. Includi qualsiasi città, regione o paese menzionato dall'utente. lat_lng (oggetto, {"latitude": number, "longitude": number}). place_id (stringa, ad esempio 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), ad esempio da search_places. intermediate_waypoints (array di oggetti - FACOLTATIVO): fino a 25 tappe da attraversare, in ordine, tra l'origine e la destinazione. Stesso formato di origin. Non supportato con TRANSIT. Includi solo le fermate richieste dall'utente. Se specifichi più di 10 tappe intermedie, i costi e la latenza saranno più elevati. travel_mode (enum - FACOLTATIVO): DRIVE (predefinito), WALK, BICYCLE o TRANSIT. Tempistica (FACOLTATIVO - imposta al massimo UN valore): timestamp RFC 3339 con un offset UTC, ad esempio '2026-09-19T08:00:00-07:00'. Il valore predefinito è la partenza immediata. Per TRANSIT, l'ora può essere impostata fino a 7 giorni nel passato o fino a 100 giorni nel futuro. Per le altre modalità, l'ora può essere impostata fino a 365 giorni nel futuro e non deve essere nel passato. departure_time: da utilizzare quando l'utente indica quando partirà (ad es. "domani alle 8:00"). arrival_time: da utilizzare quando l'utente indica l'orario di arrivo (ad es. "arrivo alle 9:00"). routing_preference (enum - FACOLTATIVO): ROUTING_PREFERENCE_TRAFFIC_UNAWARE (predefinito): ignora il traffico in tempo reale, gli incidenti e le chiusure. Latenza minima. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: utilizza le condizioni del traffico in tempo reale, se disponibili. Non supportato per WALK o BICYCLE. Imposta questo valore SOLO quando l'utente chiede informazioni sul traffico, sulla congestione o su un orario di arrivo stimato basato sul traffico. Comporta costi e latenza più elevati. location_bias (oggetto - FACOLTATIVO): {"latitude": number, "longitude": number} utilizzato per eliminare l'ambiguità dei nomi dei luoghi negli indirizzi dei waypoint. Se un nome è ambiguo (ad es. "Springfield") e l'utente non ha fornito una regione, mantieni il nome così come è stato fornito in address e imposta location_bias sull'area prevista anziché indovinare una regione. compute_alternative_routes (booleano - FACOLTATIVO): impostalo su true solo quando l'utente richiede opzioni o alternative per il percorso. Il valore predefinito è false, che restituisce solo il percorso consigliato. include_polyline (booleano - FACOLTATIVO): imposta su true solo quando è necessaria la geometria del percorso (encoded_polyline). Il valore predefinito è false. Instructions for Tool Call: Se l'origine o la destinazione non sono presenti, DEVI chiedere chiarimenti all'utente prima di chiamare lo strumento. Per le domande del tipo "Quanto dista A da B?", utilizza B come origin e A come destination. Esempio di chiamata allo strumento: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Instructions for Response: Quando vengono richiesti percorsi alternativi, questi vengono ordinati dal più consigliato al meno consigliato. Se routes è vuoto, comunica all'utente che non è stato trovato alcun percorso. Non provare a indovinare un percorso. Per trovare luoghi lungo un percorso DRIVE, passa il retrieval_token del percorso a search_along_route. Il token è valido per 10 minuti. Indica solo i fatti restituiti dallo strumento. NON inventare indicazioni stradali passo passo, linee di trasporto pubblico, stazioni, banchine o coincidenze. L'output basato su dati reali deve essere attribuito alla fonte utilizzando il campo attribution di ogni percorso, se disponibile.
search_along_route	Chiama questo strumento quando l'utente vuole trovare luoghi, attività o punti di interesse lungo un percorso di viaggio (ad es. "stazioni di servizio sulla strada per Tahoe", "bar tra SF e San Jose"). La chiamata a questo strumento comporta un costo più elevato rispetto a search_places, quindi utilizza search_places quando esegui una ricerca vicino a una singola località anziché lungo un percorso. Requisiti di input (FONDAMENTALI): text_query (stringa - OBBLIGATORIO): una descrizione in linguaggio naturale di cosa cercare lungo il percorso. Esempi: 'ev chargers', 'coffee', 'vegetarian restaurants', 'rest stops'. Route specification (MANDATORY - provide exactly ONE of the following): retrieval_token (stringa): il retrieval_token restituito da una chiamata compute_routes precedente per un percorso DRIVE. Preferisci questa opzione ogni volta che il percorso è già stato calcolato. Il token è valido per 10 minuti. route_endpoints (oggetto): origin e destination del percorso. Ognuno deve essere fornito utilizzando address, lat_lng o place_id. Esempio: {"route_endpoints": {"origin": {"address": "San Francisco, CA"}, "destination": {"address": "Lake Tahoe, CA"}}} encoded_polyline (stringa): una polilinea codificata che rappresenta un percorso DRIVE. travel_mode (enum - FACOLTATIVO): DRIVE (predefinito), WALK o BICYCLE. WALK e BICYCLE sono supportati solo con route_endpoints. TRANSIT non è supportato. routing_preference (enum - FACOLTATIVO): ROUTING_PREFERENCE_TRAFFIC_UNAWARE (valore predefinito): calcola il percorso e le deviazioni senza traffico in tempo reale. Latenza minima. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: utilizza le condizioni del traffico in tempo reale, se disponibili. Non supportato per WALK o BICYCLE. Imposta questo valore SOLO quando l'utente chiede informazioni sul traffico, sulla congestione o sui tempi di deviazione in base al traffico. Comporta una latenza maggiore. include_extended_details (booleano - FACOLTATIVO): imposta su true solo quando la richiesta richiede approfondimenti qualitativi sulle recensioni, voci di menu o offerte specifiche, atmosfera, suggerimenti o affollamento dei visitatori, disponibilità di caricabatterie EV, prezzi del carburante o altri dettagli qualitativi avanzati. Il valore predefinito è false. L'attivazione di questa opzione potrebbe aumentare la latenza. language_code (stringa - FACOLTATIVO): la lingua per il riepilogo dei risultati e i dettagli del luogo, ad esempio en, ja, en-US. Il valore predefinito è en-US. region_code (stringa - FACOLTATIVA): il codice regione CLDR Unicode dell'utente, ad esempio US, CA. Instructions for Tool Call: Ogni risultato include un detour_summary (se disponibile) che descrive la distanza aggiuntiva (localized_detour_distance) e, a meno che il percorso non sia stato fornito come encoded_polyline, il tempo aggiuntivo (detour_duration) necessario per fermarsi in quel luogo. Utilizzalo per confrontare le opzioni. La risposta summary può contenere citazioni basate su zero (ad es. "[0]") che fanno riferimento a voci in results. L'output basato su dati reali deve essere attribuito alla fonte utilizzando il campo attribution di ogni results[].place, se disponibile.
resolve_names	Risolve un elenco di query di località specifiche (nomi di punti di riferimento o indirizzi esatti) in ID luogo di Google Maps canonici. Requisiti di input (FONDAMENTALI): queries (array di oggetti - OBBLIGATORIO): un elenco di query di località da risolvere. Puoi specificare fino a 20 query. Ogni oggetto query deve avere: text (stringa - OBBLIGATORIO): la query di testo che rappresenta un nome o un indirizzo di un luogo specifico da risolvere. Esempi: 'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'. location_bias (oggetto - FACOLTATIVO): utilizza questo parametro per dare la priorità ai risultati vicini a un'area geografica specifica. Formato: {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}} region_code (stringa - FACOLTATIVO): il codice regione CLDR Unicode (codice paese di due lettere, ad esempio US, CA) dell'utente per influenzare i risultati. Instructions for Tool Call: Specificità (CRITICO): le query devono rappresentare un nome o un indirizzo di un luogo specifico. Le ricerche generiche come 'restaurants' o i nomi di catene come 'Starbucks' non sono supportati. NON chiamare questo strumento se gli strumenti downstream che prevedi di richiamare accettano già direttamente stringhe di indirizzi o nomi di luoghi non elaborati. Salva in Google Maps: La risposta include un campo save_to_maps_url: un singolo link a Google Maps contenente tutti i luoghi risolti correttamente. Quando l'utente vuole salvare, condividere o aprire i luoghi risolti come elenco in Google Maps, presentagli questo link. NON creare questo link manualmente. Gestione degli errori (CRITICO): Si tratta di uno strumento di elaborazione batch. Una richiesta potrebbe restituire "risultati misti" (ad esempio, alcune query vengono risolte correttamente, mentre altre non vanno a buon fine). L'elenco di output di results viene mappato 1:1 con gli indici queries di input. Una query non riuscita genererà un messaggio Result vuoto (nessun entity impostato) nell'indice corrispondente nell'elenco results. DEVI controllare il campo della mappa failed_requests nella risposta per identificare l'indice di query specifico che non è riuscito. La chiave di failed_requests rappresenta l'indice in base zero della query non riuscita nella richiesta. Non dare per scontato che l'intera chiamata batch non sia riuscita a causa di un errore parziale.
resolve_maps_urls	Risolve un elenco di URL di Google Maps in ID luogo canonici di Google Maps. Quando chiamare questo strumento (CRITICO): Utilizza questo strumento quando l'utente fornisce uno o più link o URL di condivisione di Google Maps (ad es. "https://maps.app.goo.gl/…", "https://www.google.com/maps/place/…" o "https://maps.google.com/…") e devi estrarre gli ID luogo canonici sottostanti. Puoi specificare fino a 20 URL da risolvere in una singola richiesta batch. Requisiti di input (FONDAMENTALI): urls (array di stringhe - OBBLIGATORIO): l'elenco degli URL di Google Maps da risolvere. Ogni URL deve essere un URL di Google Maps valido e relativo a un singolo luogo. Salva in Google Maps: La risposta include un campo save_to_maps_url: un singolo link a Google Maps contenente tutti i luoghi risolti correttamente. Quando l'utente vuole salvare, condividere o aprire i luoghi risolti come elenco in Google Maps (ad es. raccogliere i luoghi condivisi in una conversazione), presentagli questo link. NON creare questo link manualmente. Gestione degli errori (CRITICO): Si tratta di uno strumento di elaborazione batch. Una richiesta potrebbe restituire "risultati misti" (ad esempio, alcuni URL vengono risolti correttamente, mentre altri no). L'elenco di output di entities viene mappato 1:1 con gli indici urls di input. Una risoluzione dell'URL non riuscita comporterà un messaggio Entity vuoto (nessun campo impostato) nell'indice corrispondente nell'elenco entities. DEVI controllare il campo della mappa failed_requests nella risposta per identificare l'indice dell'URL specifico che non è riuscito. La chiave di failed_requests rappresenta l'indice in base zero dell'URL non riuscito nella richiesta. Non dare per scontato che l'intera chiamata batch non sia riuscita a causa di un errore parziale.

Ottieni le specifiche dello strumento MCP

Per ottenere le specifiche degli strumenti MCP per tutti gli strumenti di un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili all'interno del server MCP.

Richiesta curl
curl --location 'https://mapstools.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'