Find the best EV charge points along a route, with the REAL extra travel time of stopping at each one, never a straight-line guess. Provide `origin` + `destination` (a route is computed) or an existing route's `geometry_polyline6`, plus optional `connectors` ("ccs", "type2", "chademo", "type1", "tesla", "domestic", "other"), `min_kw` (e.g. 50 for rapid only), `available_only` and `max_detour_minutes` (default 10). Charge points come from operator-published feeds, are costed through the routing engine with your costing (a `truck` profile makes detours respect dimensional/ADR restrictions) and ranked most powerful first, since minutes off the clock are bought with kilowatts. Each result carries max_power_kw, connector_standards, best_connector, evse_count, detour_minutes/detour_km and, where a live feed backs it, available_now. IMPORTANT: there is no national charge-point registry, every deployment covers only the operators it has onboarded, so ALWAYS show the returned `coverage_note` alongside the results. An empty `results` means "none from these operators within the detour budget", NEVER "there are no chargers here". Statuses are live only when availability_live is true; otherwise they are the values captured at the last ingest and must not be described as current. `say` is ALWAYS present and is the whole answer as one short spoken line, composed by the gateway with the coverage already inside the claim rather than appended to it: it scopes its superlative to the operators this deployment holds, and an empty result's line says the emptiness is about those operators. Prefer reading it verbatim to writing your own summary. Requires the MapMap gateway; answers a clear error when the deployment has no charge-point dataset. Display the returned charging_attribution with the results.
View input schema
{
"type": "object",
"properties": {
"available_only": {
"description": "Keep only charge points with a bay reported free right now. Needs\nthe deployment to have a live availability feed; without one the\ncall is refused rather than silently returning nothing.",
"type": [
"boolean",
"null"
]
},
"connectors": {
"description": "Keep only charge points offering at least one of these connector\nstandards: \"type2\", \"type1\", \"ccs\", \"chademo\", \"tesla\", \"domestic\"\nor \"other\". Omitted ⇒ every standard.",
"items": {
"type": "string"
},
"type": [
"array",
"null"
]
},
"costing": {
"$ref": "#/$defs/CostingKind",
"default": "auto",
"description": "Costing model for the route and detour matrix: \"auto\" (default),\n\"truck\", \"bicycle\", \"pedestrian\" or \"motor_scooter\"."
},
"destination": {
"anyOf": [
{
"$ref": "#/$defs/LatLon"
},
{
"type": "null"
}
],
"description": "Route destination."
},
"geometry_polyline6": {
"description": "An existing route geometry as an encoded polyline6 (the `route`\ntool's `geometry_polyline6`). Provide either this or `origin` +\n`destination`, not both.",
"type": [
"string",
"null"
]
},
"max_detour_minutes": {
"description": "Largest acceptable detour in minutes (default 10, at most 120).",
"format": "double",
"type": [
"number",
"null"
]
},
"max_results": {
"description": "Maximum results (default 5, at most 25).",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"min_kw": {
"description": "Keep only charge points whose best connector is rated at least this\nmany kW (e.g. 50 for rapid charging only).",
"format": "double",
"type": [
"number",
"null"
]
},
"origin": {
"anyOf": [
{
"$ref": "#/$defs/LatLon"
},
{
"type": "null"
}
],
"description": "Route origin (with `destination`, when no geometry is given)."
},
"truck": {
"anyOf": [
{
"$ref": "#/$defs/TruckSpec"
},
{
"type": "null"
}
],
"description": "Truck profile (dimensions + ADR declaration). Requires costing\n\"truck\"; the detours then respect dimensional/ADR restrictions."
}
},
"$defs": {
"CostingKind": {
"description": "Costing models exposed by the MCP tools (a deliberate subset of the\nValhalla costing list), serialised in snake_case exactly as Valhalla\nnames them.",
"oneOf": [
{
"const": "auto",
"description": "Standard car costing.",
"type": "string"
},
{
"const": "truck",
"description": "Truck costing; honours dimensional limits and, when a `truck`\nprofile is supplied, ADR dangerous-goods restrictions.",
"type": "string"
},
{
"const": "bicycle",
"description": "Bicycle costing; tune it with a `bicycle` options object.",
"type": "string"
},
{
"const": "pedestrian",
"description": "Pedestrian (walking) costing; tune it with a `pedestrian` options\nobject (lit streets, wheelchair/blind, hiking difficulty).",
"type": "string"
},
{
"const": "motor_scooter",
"description": "Motor scooter (moped) costing: like auto but prefers lower-speed\nroads and may use ways closed to larger motor vehicles.",
"type": "string"
}
]
},
"LatLon": {
"anyOf": [
{
"properties": {
"lat": {
"description": "Latitude in decimal degrees (−90 to 90).",
"format": "double",
"type": "number"
},
"lon": {
"description": "Longitude in decimal degrees (−180 to 180).",
"format": "double",
"type": "number"
}
},
"required": [
"lat",
"lon"
],
"type": "object"
},
{
"description": "GeoJSON position [lon, lat]: longitude FIRST.",
"items": {
"format": "double",
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
}
],
"description": "A WGS84 coordinate in decimal degrees: a {lat, lon} object (preferred), or a GeoJSON [lon, lat] array with LONGITUDE FIRST, the same order as every polygon field on this server."
},
"TruckSpec": {
"description": "Truck profile for routing: physical dimensions plus the ADR\ndangerous-goods declaration. Omitted dimensions default to the EU\nmaximum authorised dimensions of Council Directive 96/53/EC (4.0 m\nheight, 2.55 m width, 16.5 m length, 40 t gross weight).",
"properties": {
"gross_weight_t": {
"description": "Gross combination weight in metric tonnes.",
"format": "double",
"type": [
"number",
"null"
]
},
"hazmat": {
"default": false,
"description": "Whether the vehicle carries dangerous goods (ADR). Defaults to\nfalse.",
"type": "boolean"
},
"height_m": {
"description": "Vehicle height in metres.",
"format": "double",
"type": [
"number",
"null"
]
},
"length_m": {
"description": "Vehicle length in metres.",
"format": "double",
"type": [
"number",
"null"
]
},
"tunnel_code": {
"description": "ADR 8.6.4 tunnel restriction code of the load, e.g. \"B\", \"C5000D\",\n\"B/D\", or \"(-)\"/\"none\" for explicitly unrestricted. Leave unset if\nunknown: a hazmat load without a code is conservatively treated as\ncode B (allowed only through category-A tunnels).",
"type": [
"string",
"null"
]
},
"width_m": {
"description": "Vehicle width in metres.",
"format": "double",
"type": [
"number",
"null"
]
}
},
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}