Mapport

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 1, 2026

Geocoding, places, directions, distance, and elevation through Google Maps.

VerifiedSTDIODesktop onlyLocation & LifestyleDeveloper Tools

Overview

AI-generated overview

Local MCP server that gives an assistant Google Maps Platform lookups: geocoding, place search and details, routes, distances and elevation.

What you can do
  • Convert addresses to coordinates and coordinates back to addresses
  • Search for places by text query, optionally near a point within a radius, and fetch details such as contact info, ratings and opening hours
  • Get routes with steps, distance and duration, and compute distance/duration matrices between sets of origins and destinations
  • Look up elevation above sea level for one or more coordinates
When to use it
Useful when an assistant needs real-world place, address, routing or terrain data from Google Maps while working on the user's machine, for example planning trips, resolving addresses or comparing travel times.
Requirements
Runs locally over stdio via npx or the Docker image; a Google Maps Platform API key is required in the GOOGLE_MAPS_API_KEY environment variable, and network access to Google is needed. Desktop only.
Before you install
The API key is sent to Google as a query parameter on every request, so it is a billable Google Maps Platform credential to scope and protect; calls consume Google quota and may incur charges. The server only reads map data and does not modify anything.

Installation

In SourceWeft

  1. Open Mapport in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mapport

mapport turns plain questions about places into answers from the Google Maps Platform: an address becomes coordinates, coordinates become an address, a text query becomes a list of places, and any two points become a distance, a duration, or a step-by-step route. It also reports how high a point sits above sea level. One binary serves both a command-line interface for scripts and a stdio MCP server for agents, and both faces share the same request logic.

A Google Maps Platform API key is required. Put it in the GOOGLE_MAPS_API_KEY environment variable; it is sent to Google as the key query parameter on every request and never appears in output. When the variable is missing, every call fails with an error that names it, before any request is made.

Install

bash
npx @reneturcios/mapport geocode "1600 Amphitheatre Parkway"

Or run the container image:

bash
docker run -i -e GOOGLE_MAPS_API_KEY ghcr.io/cloudcorprecords/mapport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
export GOOGLE_MAPS_API_KEY="your API key"
mapport geocode "1600 Amphitheatre Parkway, Mountain View"mapport reverse 37.422 -122.084mapport search "coffee near the ferry building" --lat 37.7955 --lng -122.3937 --radius 1500mapport details ChIJ2eUgeAK6j4ARbn5u_wAGqWAmapport distance "San Francisco" "Oakland" --to "Berkeley" --mode drivingmapport elevation 37.422,-122.084 40.0,-70.0mapport directions "San Francisco" "San Jose" --mode transit
mapport --version

Each command prints the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing GOOGLE_MAPS_API_KEY or an API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/mapport mcp

MCP client configuration:

json
{  "mcpServers": {    "mapport": {      "command": "npx",      "args": ["-y", "@reneturcios/mapport", "mcp"],      "env": { "GOOGLE_MAPS_API_KEY": "your API key" }    }  }}

Tools

ToolInputWhat it returns
maps_geocodeaddress (string, required)Matching locations with coordinates, formatted address, and place ID.
maps_reverse_geocodelatitude (number, required), longitude (number, required)The nearest address for the coordinates, with its components.
maps_search_placesquery (string, required), location (object, optional), radius (number, optional)Places matching the query, with names, addresses, and locations.
maps_place_detailsplace_id (string, required)Full details for one place: contact info, rating, reviews, and opening hours.
maps_distance_matrixorigins (string[], required), destinations (string[], required), mode (string, optional)A matrix of distances and travel durations.
maps_elevationlocations (array of {latitude, longitude}, required)Elevation in metres for each location.
maps_directionsorigin (string, required), destination (string, required), mode (string, optional)Routes with legs, steps, distance, and duration.

Google reports most API failures inside an HTTP 200 payload, in a top-level status field. mapport surfaces any status other than OK or ZERO_RESULTS as a tool error naming the status and Google's own message; ZERO_RESULTS is returned as an honest empty answer.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Source: README.md at commit d2e2fbf

Tools

7

maps_geocode

Convert a street address into geographic coordinates, a formatted address, and a place ID.

Parametersaddressrequired

maps_reverse_geocode

Convert geographic coordinates into the nearest human-readable address.

Parameterslatituderequiredlongituderequired

maps_search_places

Search for places matching a text query, optionally centred on a location within a radius.

Parametersqueryrequiredradiuslocation

maps_place_details

Fetch detailed information about one place, including contact details, ratings, and opening hours.

Parametersplace_idrequired

maps_distance_matrix

Calculate travel distances and durations between sets of origins and destinations.

Parametersmodeoriginsrequireddestinationsrequired

maps_elevation

Look up the elevation above sea level for one or more geographic coordinates.

Parameterslocationsrequired

maps_directions

Get route directions between an origin and a destination, with steps, distance, and duration.

Parametersmodeoriginrequireddestinationrequired

Version history

1
  1. v0.1.0LatestOct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts