KosmoKrator

other

Google Maps MCP Integration for OpenAI Agents SDK

Connect Google Maps to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write API key auth
Submit Google Maps feedback View package source

Connect Google Maps to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Google Maps MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-google-maps": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google-maps",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=google-maps --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Google Maps instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Google Maps Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Google Maps integration catalog.

MCP toolSource functionTypeDescription
integration__google_maps__google_maps_geocode_address google-maps.google_maps_geocode_address Read Convert a street address into geographic coordinates and place details using Google Maps geocoding.
integration__google_maps__google_maps_reverse_geocode google-maps.google_maps_reverse_geocode Read Convert latitude and longitude coordinates into street addresses using Google Maps reverse geocoding.
integration__google_maps__google_maps_search_places google-maps.google_maps_search_places Read Search for places with a text query using Google Maps Places search.
integration__google_maps__google_maps_get_place_details google-maps.google_maps_get_place_details Read Get detailed information about a specific Google Maps place by Place ID.
integration__google_maps__google_maps_get_directions google-maps.google_maps_get_directions Read Get directions between an origin and destination using Google Maps Directions API.
integration__google_maps__google_maps_get_distance_matrix google-maps.google_maps_get_distance_matrix Read Calculate travel distances and durations between multiple origins and destinations.
integration__google_maps__google_maps_get_current_user google-maps.google_maps_get_current_user Read Get geolocation data for the current requester and verify Google Maps API credentials.

Related Google Maps Pages

Google Maps CLIUse direct JSON commands instead of MCP discovery. Google Maps MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.