@mcp-monorepo/maps

MCP server providing geospatial tools powered by the Stadia Maps API.

This package provides a set of powerful geospatial tools for the Model Context Protocol, powered by the Stadia Maps API. It enables models to perform tasks like geocoding addresses, calculating routes, generating isochrones, fetching timezone information, and creating static map images.

Key Features

• Geocoding: Convert addresses and place names into geographic coordinates and vice-versa, with both single and bulk lookup capabilities.
• Routing: Calculate travel time, distance, and route geometry between multiple points for various travel modes (car, bike, pedestrian).
• Isochrones: Generate reachable areas (polygons) from a point based on time or distance constraints.
• Timezone Lookup: Get detailed timezone information, including offsets and current local time, for any coordinate.
• Rate-Limited: All API calls are automatically throttled to respect API usage limits.

Usage

You can run this MCP server directly using npx for local testing:

npx @mcp-monorepo/maps@latest

To integrate this server with a compatible AI model (like Claude), provide the following MCP server configuration:

{
  "mcpServers": {
    "maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-monorepo/maps"
      ],
      "env": {
        "STADIA_API_KEY": "<Your STADIA_API_KEY Here>"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | | :--- | :--- | :--- | | STADIA_API_KEY | Your Stadia Maps API key. This is required for all tools to function. | <required> |

Tools

time-and-zone-info

Get Time and Timezone - Get the current time and timezone info for a specific geographic coordinate (latitude/longitude).

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | lat | number | The latitude of the geographic point. | | lon | number | The longitude of the geographic point. |

geocode

Geocode Address or Place - Look up a single street address, point of interest (POI), or area. Returns detailed geographic information.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | query | string | The address or place name to search for. For best results with POIs (e.g., "Starbucks"), provide a focusPoint. | | countryFilter | array of string | An array of country codes to filter the search results. | | lang | string | A BCP-47 language tag to localize the results (e.g. "en", "de"). | | focusPoint | object | A coordinate pair to focus the search around, improving result relevance. Provide whenever possible. | | focusPoint.lat | number | The latitude of the geographic point. | | focusPoint.lon | number | The longitude of the geographic point. | | layer | string | The layer to search in. coarse for areas, address for streets, poi for points of interest, etc. Defaults to all layers. |

bulk-geocode

Bulk Geocode Addresses - Perform multiple address geocoding operations in a single request. Best for addresses, not POIs.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | items | array of object | Array of geocoding items to process. |

route-overview

Get Route Overview - Get high-level routing information between two or more locations, including travel time, distance, and an encoded polyline.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | locations | array of object | | | costing | string | The method of travel to use for routing. | | units | string | The unit of measurement for distances (kilometers or miles). |

isochrone

Generate Isochrone Contours - Generate polygons (isochrones) showing areas reachable within specified time or distance constraints from a single location.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | location | object | A geographic coordinate pair (latitude, longitude). | | location.lat | number | The latitude of the geographic point. | | location.lon | number | The longitude of the geographic point. | | costing | string | The method of travel for isochrone calculation. | | contours | array of object | An array of 1-4 contours, each defined by either time or distance. |

static-map

Generate Static Map Image - Generate a PNG map image of an area, optionally including markers and a line (e.g., to draw a route or a boundary).

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | style | string | The visual style of the map theme. | | size | string | The dimensions of the map image in pixels, e.g., "800x600". Add "@2x" for high-resolution (retina) display. | | encodedPolyline | string | An encoded polyline (precision 6) to draw on the map, typically from a routing result. | | strokeColor | string | Color for the polyline (hex code without "#" or CSS color name, e.g., "FF0000" or "blue"). | | strokeWidth | number | Width of the polyline in pixels. | | markers | array of object | An array of markers to place on the map. |

Other MCP Servers

This monorepo contains several other MCP server packages available on npm. Each provides a distinct set of tools for use with the Model Context Protocol.

• @mcp-monorepo/confluence: MCP server for Confluence API tools
• @mcp-monorepo/file-browser: MCP server for file system browsing and manipulation (search, ls, tree, grep, open, write, move, mkdir)
• @mcp-monorepo/ics: MCP server for calendar tools using ICS/ical feeds
• @mcp-monorepo/jira: MCP server for Jira tools (JQL, issue management, etc.).
• @mcp-monorepo/location: MCP server for location-based tools using IP address lookup
• @mcp-monorepo/mail: MCP server for mail tools (fetch, read, search, mark as seen).
• @mcp-monorepo/notion-query: MCP server for querying Notion data sources.
• @mcp-monorepo/npm: MCP server for npm command tools (run scripts, install packages, list scripts)
• @mcp-monorepo/slack: Slack MCP to access workspace without bot account or app
• @mcp-monorepo/weather: Weather MCP tools (geocoding, weather-by-coords) for ModelContextProtocol.

Authors

• The MCP Monorepo Team

License

This project is licensed under the AGPL-3.0-only License. See the LICENSE file for details.