mapsource-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Enables desktop agents and clients to access geospatial services via a hosted MCP server, including OpenStreetMap queries, address and business search, POI discovery, routing, matrices, isochrones, map matching, optimization, elevation and terrain, basemap styling, spatial analysis, rendering, usage, and service status.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "mapsource-mcp": {
      "url": "https://mapsource.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• service_status

  Read Overpass engine readiness, dataset timestamp, billing state, and x402 payment mode. Public. Use geo_data with operation status for the full subsystem report.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• basemap_catalog read-only

  List raster and vector tile templates, source zoom ranges, dataset snapshots, and attribution. The catalog is public; tile requests require a subscription key.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• elevation read-only

  Sample terrain at lat/lon. elevationMeters is clamped to zero; sampledMeters retains the raw model elevation. belowSeaLevel identifies negative samples and bathymetryTile references the source raster. Requires a subscription key. Not survey-grade.

  Parameters:

  • lat (required) — number — Latitude in decimal degrees.
  • lon (required) — number — Longitude in decimal degrees.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• geo_data read-only

  Read service status, basemap catalog, point elevation, contours, usage, and metrics. Status includes subsystem availability and replication lag. Elevation returns surface and raw model heights. Metrics report request rates, success rates, latency percentiles, and dataset ages. Status and basemaps are public; other operations require a subscription key.

  Parameters:

  • operation (required) — string — status: service state and dataset freshness. basemaps: tile catalogue. elevation: ground height at a point. contours: banded topographic contours. usage: this key's consumption. metrics: request rates, latency percentiles and how old each dataset is.
  • lat — number — elevation and contours: latitude.
  • lon — number — elevation and contours: longitude.
  • zoom — integer — contours only: detail level, 6 to 13. Defaults to 9.
  • bands — integer — contours only: how many elevation bands, 4 to 24. Defaults to 14.
  • window — integer — metrics only: minutes to measure over. Defaults to 60.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• geo_style

  Configure semantic basemap styles. Operations: explain and schema retrieve public definitions; intent generates a proposal; preview compiles changes; save, list, revisions, diff, and delete manage profiles. Submit semantic manifests or preset patches, not raw MapLibre JSON. Authenticated operations affect the current key's profiles.

  Parameters:

  • to — integer — diff only: the later revision. Defaults to the current one.
  • base — string — Base preset for the patch. Available presets are listed at /api/styles.
  • from — integer — diff only: the earlier revision. Defaults to the one before `to`.
  • name — string — save only: a human name for the profile.
  • save — boolean — intent only: also save the proposal as a profile revision on this key.
  • slug — string — save and delete: the profile's stable URL id. Defaults to a slug of the name on save.
  • patch — object — Semantic overrides: {"tokens":{...},"typography":{...},"layers":{"roads.motorway":{"color":"#f2a900"}}}. Layer keys come from the explain operation.
  • intent — string — intent: text description of the desired basemap. Returns an editable manifest and a summary of applied changes.
  • operation — string — explain: layer definitions. schema: manifest JSON Schema. intent: generate a style proposal. preview: compile without saving. save: store a profile. list: available presets and profiles. revisions: saved versions. diff: revision comparison. delete: remove a profile.
  • description — string — save: profile description.
  • includeStyle — boolean — Include the compiled MapLibre style in addition to the hash, diff, and validation issues. Defaults to false.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• geo_render read-only

  Render a static PNG map from a center and zoom or bounding box. Supports GeoJSON overlays, result handles, and up to 50 labeled markers. Dark and light styles use raster rendering; other preset or profile names use vector rendering. Requires a subscription key.

  Parameters:

  • lat — number
  • lon — number
  • bbox — array — [west, south, east, north]. Fits the viewport to this instead of using lat/lon/zoom.
  • zoom — number
  • pitch — number — Vector renders only.
  • style — string — dark or light composites the raster basemaps. Any other value names a style preset or one of your saved basemap profiles and is rendered as vector against that compiled style.
  • width — integer
  • height — integer
  • bearing — number — Vector renders only.
  • geojson — GeoJSON to draw, or a result handle such as rh_ followed by 32 hex characters.
  • markers — array
  • styleRevision — integer — Saved profile revision to use for rendering.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• geo_analyze read-only

  Measure or transform geometry using buffer, centroid, bbox, area, length, distance, intersect, union, difference, contains, intersects, nearest, simplify, or convex. Inputs accept GeoJSON, coordinate pairs, Overpass results, and result handles. Polygon overlay operations require areas. Use operation pipeline for up to 12 ordered steps and estimateOnly for cost estimation. Requires a subscription key.

  Parameters:

  • operation (required) — string — buffer and simplify take distance. distance, intersect, union, difference, contains, intersects and nearest take a second geometry in b. pipeline runs several steps server-side and takes pipeline instead of a.
  • a — GeoJSON, a [lon, lat] pair, an Overpass result, a places result, or a result handle such as rh_ followed by 32 hex characters. Required for every operation except pipeline.
  • b — The second operand, in the same forms as a.
  • units — string
  • returns — string — pipeline only: which step to return, as $stepId. Defaults to the last.
  • distance — number — Buffer radius or simplify tolerance.
  • pipeline — array — pipeline only: ordered steps. Any argument may be $anEarlierStepId.
  • estimateOnly — boolean — pipeline: calculate estimated cost without execution.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• geo_search read-only

  Search places and retrieve geographic entities. Use lookup for local address, business, brand and landmark search with soft map-focus bias, strict house numbers, source IDs and ambiguity reporting. Use discover for POIs in a viewport, polygon or isochrone, optionally ranked by travel time. Other operations: search, autocomplete, nearby, reverse, details, geocode, resolve, entity. Requires a subscription key.

  Parameters:

  • operation (required) — string — lookup: local address, business and brand suggestions with soft map-focus bias. discover: businesses in a viewport, polygon or isochrone, optionally ranked by travel time. resolve: name to entity ID. entity: entity lookup. search: populated-place names. autocomplete: populated-place prefixes. nearby: radius search. reverse: coordinate lookup. details: OSM type and ID lookup. geocode: compatibility provider; use lookup for new integrations.
  • q — string — lookup: address/name text, 1–120 characters. discover: optional name/brand filter. search/autocomplete: populated-place name. geocode: compatibility provider query.
  • lat — number
  • lon — number
  • bbox — string — west,south,east,north. lookup: soft focus unless bounded is true. discover: required region boundary unless region or minutes is supplied.
  • limit — integer
  • osmId — integer — details only.
  • types — string — lookup: comma-separated address,business,landmark,street,place.
  • offset — integer — discover: result page offset.
  • radius — integer — Metres. Defaults to 500 for nearby and 150 for reverse.
  • rankBy — string — discover: travel_time compares the nearest 25 candidates.
  • region — discover: polygon GeoJSON or owned result handle; alternatively supply bbox or minutes.
  • bounded — boolean — lookup: explicitly restrict results to bbox.
  • costing — string
  • minutes — integer — discover: generate an isochrone from lat/lon.
  • osmType — string — details only.
  • category — string — lookup/discover: business or POI category, such as coffee, pharmacy or restaurants. nearby: feature category, such as cafe, restaurant, hospital or park.
  • entityId — string — entity only: an id from resolve, beginning geo_.
  • language — string — lookup: preferred language, default en.
  • placeClass — string — search and autocomplete: restrict to one class of populated place.
  • countrycodes — string — lookup: comma-separated two-letter country filters.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• geo_navigate read-only

  Navigation operations: route, matrix, isochrone, map_match, snap, and optimize. Route accepts 2–10 waypoints and optional elevation profiles. Matrix supports up to 625 pairs. Map matching accepts up to 1,000 trace points; optimization accepts 3–20 stops. Results include geometry or travel costs and source metadata. Requires a subscription key. Unroutable requests return an error and require revised inputs.

  Parameters:

  • operation (required) — string — route: turn-by-turn between waypoints. matrix: many-to-many times and distances. isochrone: reachable-area polygons. map_match: fit a GPS trace to the road network. snap: nearest network point. optimize: best visit order.
  • costing — string — Travel mode used to weight the road graph.
  • sources — array — matrix only: the origins.
  • targets — array — matrix only: the destinations. Omit for a square matrix of sources against themselves.
  • contours — array — isochrone only: travel-time bands in minutes.
  • elevation — boolean — route only: also return a sampled terrain profile with total gain and loss.
  • locations — array — Waypoints for route and optimize, points for snap, or the ordered trace for map_match. For isochrone, the single origin.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• route read-only

  Calculate a turn-by-turn route between 2–10 waypoints. Supported costing: auto, bicycle, pedestrian, truck, motor_scooter, and bus. Returns GeoJSON, distance, duration, and maneuvers. Set elevation to true for a terrain profile with gain and loss. Requires a subscription key.

  Parameters:

  • locations (required) — array — Ordered waypoints, 2 to 10; first is the origin and last is the destination.
  • costing — string — Travel mode used to weight the road graph.
  • elevation — boolean — Sample a terrain profile along the route and report total gain and loss in metres.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• isochrone read-only

  Calculate reachable-area polygons from a coordinate for up to four travel-time bands. Returns GeoJSON for catchment, coverage, and accessibility analysis. Requires a subscription key.

  Parameters:

  • lat (required) — number — Latitude of the centre point.
  • lon (required) — number — Longitude of the centre point.
  • costing — string — Travel mode used to weight the road graph.
  • contours — array — Travel-time bands in minutes, at most four.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• overpass_query

  Execute bounded Overpass QL over OSM nodes, ways, relations, tags, geometry, areas, metadata, and spatial selectors. Historical attic queries are unsupported. Requires a subscription key or authorized x402 payment. Use service_status to retrieve the dataset timestamp.

  Parameters:

  • query (required) — string — A complete bounded Overpass QL query, with explicit timeout and output limit.
  • responseMode — string — compact: inline when small, a result handle when large. handle: always a handle. raw: always the full body, however large.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_features

  Find cafes, restaurants, buildings, parks, schools, hospitals, transit stops, drinking water, or trails within a bounding box up to 0.5 degrees per axis. Returns OSM geometry and tags, subject to the output limit. Requires a subscription key or authorized x402 payment.

  Parameters:

  • category (required) — string — Mapped feature category; use overpass_query for arbitrary OSM tags.
  • south (required) — number
  • west (required) — number
  • north (required) — number
  • east (required) — number
  • limit — integer — Maximum returned OSM objects, not a pagination guarantee.
  • responseMode — string — compact: inline when small, a result handle when large. handle: always a handle. raw: always the full body, however large.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.