OpenStreetMap queries, maps/styles, search, routing, terrain, analysis, pipelines, and rendering.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer YOUR_MAPSOURCE_API_KEY. Optional for public discovery/status/catalog; required for subscription-protected tools. Never put keys in URLs.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
List raster and vector tile templates, source zoom ranges, dataset snapshots, and attribution. The catalog is public; tile requests require a subscription key.
This tool takes no arguments.
List raster and vector tile templates, source zoom ranges, dataset snapshots, and attribution. The catalog is public; tile requests require a subscription key.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| lat* | number | Latitude in decimal degrees. |
| lon* | number | Longitude in decimal degrees. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878,
"description": "Latitude in decimal degrees."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in decimal degrees."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| east* | number | |
| west* | number | |
| limit | integer | Maximum returned OSM objects, not a pagination guarantee. |
| north* | number | |
| south* | number | |
| category* | string | Mapped feature category; use overpass_query for arbitrary OSM tags. |
| responseMode | string | compact: inline when small, a result handle when large. handle: always a handle. raw: always the full body, however large. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"category",
"south",
"west",
"north",
"east"
],
"properties": {
"east": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"west": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"limit": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1,
"description": "Maximum returned OSM objects, not a pagination guarantee."
},
"north": {
"type": "number",
"maximum": 85,
"minimum": -85
},
"south": {
"type": "number",
"maximum": 85,
"minimum": -85
},
"category": {
"enum": [
"cafes",
"restaurants",
"buildings",
"parks",
"schools",
"hospitals",
"transit_stops",
"drinking_water",
"trails"
],
"type": "string",
"description": "Mapped feature category; use overpass_query for arbitrary OSM tags."
},
"responseMode": {
"enum": [
"compact",
"handle",
"raw"
],
"type": "string",
"default": "compact",
"description": "compact: inline when small, a result handle when large. handle: always a handle. raw: always the full body, however large."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| a | any | 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 | any | 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. |
| operation* | 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. |
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| operation* | 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operation"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878,
"description": "elevation and contours: latitude."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "elevation and contours: longitude."
},
"zoom": {
"type": "integer",
"maximum": 13,
"minimum": 6,
"description": "contours only: detail level, 6 to 13. Defaults to 9."
},
"bands": {
"type": "integer",
"maximum": 24,
"minimum": 4,
"description": "contours only: how many elevation bands, 4 to 24. Defaults to 14."
},
"window": {
"type": "integer",
"maximum": 1440,
"minimum": 1,
"description": "metrics only: minutes to measure over. Defaults to 60."
},
"operation": {
"enum": [
"status",
"basemaps",
"elevation",
"contours",
"usage",
"metrics"
],
"type": "string",
"description": "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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| operation* | 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. |
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
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.
| Argument | Type | Description |
|---|---|---|
| lat* | number | Latitude of the centre point. |
| lon* | 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878,
"description": "Latitude of the centre point."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the centre point."
},
"costing": {
"enum": [
"auto",
"bicycle",
"pedestrian",
"truck",
"motor_scooter",
"bus"
],
"type": "string",
"default": "auto",
"description": "Travel mode used to weight the road graph."
},
"contours": {
"type": "array",
"items": {
"type": "number",
"maximum": 60,
"minimum": 1
},
"default": [
10
],
"maxItems": 4,
"minItems": 1,
"description": "Travel-time bands in minutes, at most four."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| query* | 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 131072,
"minLength": 1,
"description": "A complete bounded Overpass QL query, with explicit timeout and output limit."
},
"responseMode": {
"enum": [
"compact",
"handle",
"raw"
],
"type": "string",
"default": "compact",
"description": "compact: inline when small, a result handle when large. handle: always a handle. raw: always the full body, however large."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| locations* | array | Ordered waypoints, 2 to 10; first is the origin and last is the destination. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"locations"
],
"properties": {
"costing": {
"enum": [
"auto",
"bicycle",
"pedestrian",
"truck",
"motor_scooter",
"bus"
],
"type": "string",
"default": "auto",
"description": "Travel mode used to weight the road graph."
},
"elevation": {
"type": "boolean",
"default": false,
"description": "Sample a terrain profile along the route and report total gain and loss in metres."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 10,
"minItems": 2,
"description": "Ordered waypoints, 2 to 10; first is the origin and last is the destination."
}
}
}Read Overpass engine readiness, dataset timestamp, billing state, and x402 payment mode. Public. Use geo_data with operation status for the full subsystem report.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}| estimateOnly | boolean | pipeline: calculate estimated cost without execution. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operation"
],
"properties": {
"a": {
"description": "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": {
"description": "The second operand, in the same forms as a."
},
"units": {
"enum": [
"meters",
"kilometers",
"miles"
],
"type": "string",
"default": "meters"
},
"returns": {
"type": "string",
"description": "pipeline only: which step to return, as $stepId. Defaults to the last."
},
"distance": {
"type": "number",
"maximum": 500000,
"minimum": 0,
"description": "Buffer radius or simplify tolerance."
},
"pipeline": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"op"
],
"properties": {
"id": {
"type": "string",
"description": "Referenced by later steps as $id."
},
"op": {
"enum": [
"search",
"nearby",
"route",
"isochrone",
"matrix",
"analyze",
"filter",
"sort",
"limit"
],
"type": "string"
},
"args": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"maxItems": 12,
"description": "pipeline only: ordered steps. Any argument may be $anEarlierStepId."
},
"operation": {
"enum": [
"buffer",
"centroid",
"bbox",
"area",
"length",
"distance",
"intersect",
"union",
"difference",
"contains",
"intersects",
"nearest",
"simplify",
"convex",
"pipeline"
],
"type": "string",
"description": "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."
},
"estimateOnly": {
"type": "boolean",
"default": false,
"description": "pipeline: calculate estimated cost without execution."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operation"
],
"properties": {
"costing": {
"enum": [
"auto",
"bicycle",
"pedestrian",
"truck",
"motor_scooter",
"bus"
],
"type": "string",
"default": "auto",
"description": "Travel mode used to weight the road graph."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 25,
"description": "matrix only: the origins."
},
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 25,
"description": "matrix only: the destinations. Omit for a square matrix of sources against themselves."
},
"contours": {
"type": "array",
"items": {
"type": "number",
"maximum": 60,
"minimum": 1
},
"maxItems": 4,
"description": "isochrone only: travel-time bands in minutes."
},
"elevation": {
"type": "boolean",
"default": false,
"description": "route only: also return a sampled terrain profile with total gain and loss."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 1000,
"description": "Waypoints for route and optimize, points for snap, or the ordered trace for map_match. For isochrone, the single origin."
},
"operation": {
"enum": [
"route",
"matrix",
"isochrone",
"map_match",
"snap",
"optimize"
],
"type": "string",
"description": "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."
}
}
}| geojson |
| any |
| 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"bbox": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"description": "[west, south, east, north]. Fits the viewport to this instead of using lat/lon/zoom."
},
"zoom": {
"type": "number",
"maximum": 19,
"minimum": 0
},
"pitch": {
"type": "number",
"default": 0,
"maximum": 60,
"minimum": 0,
"description": "Vector renders only."
},
"style": {
"type": "string",
"default": "dark",
"maxLength": 64,
"minLength": 1,
"description": "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": {
"type": "integer",
"default": 800,
"maximum": 2048,
"minimum": 64
},
"height": {
"type": "integer",
"default": 600,
"maximum": 2048,
"minimum": 64
},
"bearing": {
"type": "number",
"default": 0,
"maximum": 180,
"minimum": -180,
"description": "Vector renders only."
},
"geojson": {
"description": "GeoJSON to draw, or a result handle such as rh_ followed by 32 hex characters."
},
"markers": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"label": {
"type": "string",
"maxLength": 24
}
}
},
"maxItems": 50
},
"styleRevision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Saved profile revision to use for rendering."
}
}
}| radius | integer | Metres. Defaults to 500 for nearby and 150 for reverse. |
| rankBy | string | discover: travel_time compares the nearest 25 candidates. |
| region | any | 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. |
| operation* | 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. |
| placeClass | string | search and autocomplete: restrict to one class of populated place. |
| countrycodes | string | lookup: comma-separated two-letter country filters. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operation"
],
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "lookup: address/name text, 1–120 characters. discover: optional name/brand filter. search/autocomplete: populated-place name. geocode: compatibility provider query."
},
"lat": {
"type": "number",
"maximum": 85.05112878,
"minimum": -85.05112878
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"bbox": {
"type": "string",
"maxLength": 120,
"description": "west,south,east,north. lookup: soft focus unless bounded is true. discover: required region boundary unless region or minutes is supplied."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"osmId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "details only.",
"exclusiveMinimum": 0
},
"types": {
"type": "string",
"maxLength": 100,
"description": "lookup: comma-separated address,business,landmark,street,place."
},
"offset": {
"type": "integer",
"maximum": 2000,
"minimum": 0,
"description": "discover: result page offset."
},
"radius": {
"type": "integer",
"maximum": 5000,
"minimum": 10,
"description": "Metres. Defaults to 500 for nearby and 150 for reverse."
},
"rankBy": {
"enum": [
"distance",
"travel_time"
],
"type": "string",
"description": "discover: travel_time compares the nearest 25 candidates."
},
"region": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
],
"description": "discover: polygon GeoJSON or owned result handle; alternatively supply bbox or minutes."
},
"bounded": {
"type": "boolean",
"description": "lookup: explicitly restrict results to bbox."
},
"costing": {
"enum": [
"auto",
"bicycle",
"pedestrian",
"truck"
],
"type": "string"
},
"minutes": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "discover: generate an isochrone from lat/lon."
},
"osmType": {
"enum": [
"node",
"way",
"relation"
],
"type": "string",
"description": "details only."
},
"category": {
"type": "string",
"maxLength": 40,
"description": "lookup/discover: business or POI category, such as coffee, pharmacy or restaurants. nearby: feature category, such as cafe, restaurant, hospital or park."
},
"entityId": {
"type": "string",
"maxLength": 300,
"minLength": 4,
"description": "entity only: an id from resolve, beginning geo_."
},
"language": {
"type": "string",
"maxLength": 12,
"description": "lookup: preferred language, default en."
},
"operation": {
"enum": [
"search",
"autocomplete",
"nearby",
"reverse",
"details",
"geocode",
"resolve",
"entity",
"lookup",
"discover"
],
"type": "string",
"description": "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."
},
"placeClass": {
"enum": [
"city",
"town",
"village",
"suburb",
"neighbourhood",
"hamlet"
],
"type": "string",
"description": "search and autocomplete: restrict to one class of populated place."
},
"countrycodes": {
"type": "string",
"maxLength": 40,
"description": "lookup: comma-separated two-letter country filters."
}
}
}| 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "diff only: the later revision. Defaults to the current one."
},
"base": {
"enum": [
"light",
"dark",
"operations"
],
"type": "string",
"default": "dark",
"description": "Base preset for the patch. Available presets are listed at /api/styles."
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "diff only: the earlier revision. Defaults to the one before `to`."
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "save only: a human name for the profile."
},
"save": {
"type": "boolean",
"default": false,
"description": "intent only: also save the proposal as a profile revision on this key."
},
"slug": {
"type": "string",
"maxLength": 48,
"minLength": 2,
"description": "save and delete: the profile's stable URL id. Defaults to a slug of the name on save."
},
"patch": {
"type": "object",
"default": {},
"description": "Semantic overrides: {\"tokens\":{...},\"typography\":{...},\"layers\":{\"roads.motorway\":{\"color\":\"#f2a900\"}}}. Layer keys come from the explain operation.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"intent": {
"type": "string",
"maxLength": 2000,
"minLength": 3,
"description": "intent: text description of the desired basemap. Returns an editable manifest and a summary of applied changes."
},
"operation": {
"enum": [
"explain",
"schema",
"intent",
"preview",
"save",
"list",
"revisions",
"diff",
"delete"
],
"type": "string",
"default": "preview",
"description": "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": {
"type": "string",
"maxLength": 400,
"description": "save: profile description."
},
"includeStyle": {
"type": "boolean",
"default": false,
"description": "Include the compiled MapLibre style in addition to the hash, diff, and validation issues. Defaults to false."
}
}
}