MCP Tools Reference: mapstools.googleapis.com

MCP-Tools-Referenz:

In diesem Dokument werden die externen REST API-Endpunkte beschrieben, die zum Aufrufen von Google-MCP-Tools (Model Context Protocol) verwendet werden. Diese API fungiert als sicherer Proxy zwischen einem externen HTTP-Client (z. B. curl oder ein Webdienst) und dem internen MCP-Server.

Spezifikationen für das MCP-Tool abrufen

Wenn Sie die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abrufen möchten, verwenden Sie die Methode `tools/list`. Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um alle Tools und ihre Spezifikationen aufzulisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
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
}'

Tool: search_places

Rufen Sie dieses Tool auf, wenn der Nutzer nach Orten, Unternehmen, Adressen, Standorten, Sehenswürdigkeiten oder anderen Google Maps-bezogenen Suchanfragen sucht.

Anforderungen an die Eingabe (WICHTIG):

  1. text_query (String – ERFORDERLICH): Die primäre Suchanfrage. Darin muss klar definiert werden, wonach der Nutzer sucht.

    • Beispiele: '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'.
    • Für bestimmte Ortsdetails:Geben Sie das angeforderte Attribut an, z.B. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (Objekt – OPTIONAL): Damit können Sie Ergebnisse in der Nähe eines bestimmten geografischen Gebiets priorisieren.

    • Format:{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Verwendung:
      • Um einen Radius von 5 km zu bevorzugen:{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Starke Gewichtung des Mittelpunkts: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters wird ausgelassen).

  3. language_code (String – OPTIONAL): Die Sprache, in der die Zusammenfassung der Suchergebnisse angezeigt werden soll.

    • Format:Ein aus zwei Buchstaben bestehender Sprachcode (ISO 639-1), optional gefolgt von einem Unterstrich und einem aus zwei Buchstaben bestehenden Ländercode (ISO 3166-1 alpha-2), z.B. en, ja, en_US, zh_CN, es_MX. Wenn der Sprachcode nicht angegeben wird, sind die Ergebnisse auf Englisch.

  4. region_code (String – OPTIONAL): Der Unicode-CLDR-Regionscode des Nutzers. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

    • Format:Ein aus zwei Buchstaben bestehender Ländercode (ISO 3166-1 alpha-2), z.B. US, CA.

Instructions for Tool Call:

  • Standortinformationen (KRITISCH): Die Suche muss ausreichend Standortinformationen enthalten. Wenn der Standort nicht eindeutig ist (z.B. nur „Pizzerien“), müssen Sie ihn in text_query angeben (z.B. „Pizzerien in New York“) oder verwenden Sie den Parameter location_bias. Geben Sie bei Bedarf den Namen der Stadt, des Bundesstaats/der Provinz und der Region/des Landes an, um Mehrdeutigkeiten zu vermeiden.

  • Geben Sie immer die spezifischste und kontextbezogenste text_query an, die möglich ist.

  • Verwenden Sie location_bias nur, wenn Koordinaten explizit angegeben werden oder wenn es angemessen und notwendig ist, einen Standort aus dem bekannten Kontext eines Nutzers abzuleiten, um bessere Ergebnisse zu erzielen.

Die folgenden Beispiele zeigen, wie Sie das MCP-Tool „search_places“ mit curl aufrufen.

Curl-Anfrage 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Tool: lookup_weather

Bietet aktuelle Bedingungen sowie stündliche und tägliche Vorhersagen für jeden Ort. Verwenden Sie dieses Tool für alle wetterbezogenen Anfragen.

Verfügbare spezifische Daten:Temperatur (aktuell, gefühlte Temperatur, Höchst-/Tiefsttemperatur, Hitzeindex), Wind (Geschwindigkeit, Böen, Richtung), Himmelsereignisse (Sonnenaufgang/-untergang, Mondphase), Niederschlag (Art, Wahrscheinlichkeit, Menge/QPF), atmosphärische Bedingungen (UV-Index, Luftfeuchtigkeit, Wolkendecke, Wahrscheinlichkeit von Gewittern) und geocodierte Standortadresse.

Anforderungen an die Eingabe (WICHTIG):

  • Aktuelle Bedingungen:Hier ist nur ein Standort (z.B. Stadt oder Adresse) erforderlich. Geben Sie kein Datum oder keine Uhrzeit an.

  • Vorhersagen nach Stunden:Erfordert einen Standort und eine Stunde (0–23). Verwende diese Antwort, wenn der Nutzer nach dem Wetter zu einer bestimmten Zeit oder mit Begriffen wie „in den nächsten Stunden“ oder „später heute“ fragt.

  • Tagesvorhersagen:Hierfür sind ein Standort und ein vollständiges Datum erforderlich.

Datumsangaben (WICHTIG): Vom Nutzer bereitgestellte Datumsangaben und Uhrzeiten MÜSSEN in der lokalen Zeitzone des angeforderten Standorts angegeben werden. Datumsangaben MÜSSEN in separate Ganzzahlparameter aufgeteilt werden: Jahr, Monat und Tag. Das erforderliche Format für diese Parameter ist: {"year": , "month": , "day": }

Die folgenden Beispiele zeigen, wie Sie das MCP-Tool „lookup_weather“ mit curl aufrufen.

Curl-Anfrage 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Tool: compute_routes

Berechnet eine Reiseroute zwischen einem angegebenen Start- und Zielort. Unterstützte Mobilitätsformen:DRIVE (Standard), WALK.

Anforderungen an die Eingabe (WICHTIG): Sowohl Ursprung als auch Ziel sind erforderlich. Jeder muss mit einer der folgenden Methoden im jeweiligen Feld angegeben werden:

  • address (String, z.B. Eiffelturm, Paris“). Hinweis: Je detaillierter oder spezifischer die eingegebene Adresse ist, desto besser sind die Ergebnisse.

  • lat_lng: (Objekt, {„latitude“: number, „longitude“: number})

  • place_id:: (String, z.B. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Hinweis: Diese ID kann über das Tool „search_places“ abgerufen werden. Beliebige Kombinationen von Eingabetypen sind zulässig, z.B. Ursprung nach Adresse und Ziel nach lat_lng. Wenn entweder der Start- oder der Zielort fehlt, MÜSSEN Sie den Nutzer um Klärung bitten, bevor Sie versuchen, das Tool aufzurufen.

Beispiel für Tool-Aufruf: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

Die folgenden Beispiele zeigen, wie Sie das MCP-Tool „compute_routes“ mit curl aufrufen.

Curl-Anfrage 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'