openchargemap-mcp-server: find stations
openchargemap_find_stationsFind EV charging stations from the global Open Charge Map registry near a point or within a bounding box. Provide either a center (latitude + longitude + distance) or a boundingbox; optionally scope to a country with countrycode. This tool is coordinate-native and does not geocode place names — resolve a place like "Ballard, Seattle" to coordinates with openstreetmap_search_places first, then pass them here. Filter by connector type, minimum power (kW), operator/network, usage type (public/free/membership), charge level, operational status, and minimum charge points. Filter IDs are integers — resolve a connector or network name to its IDs with openchargemap_lookup_reference and pass every returned ID (e.g. "CCS" -> [32, 33]; Open Charge Map distinguishes CCS Type 1 (32, common in North America) and Type 2 (33, common in Europe); 33 alone can miss Type 1 stations). Each result includes title, address, distance from the search point, connections (type, power, count), operator, access rules, registry operational status, and the last-verified date. Results come back one page at a time: when a page reports truncated, repeat the same search with the reported nextOffset to read the next one.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "openchargemap_find_stations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | Matching stations to skip before the returned page, for reading past a truncated result. Repeat the same search with the nextOffset value the previous call reported. One search reaches at most 500 stations, so 499 is the deepest offset that can return one — narrow the area or add filters to reach stations beyond that. Ordering is by distance and stable, but Open Charge Map is edited continuously, so a station added or removed between pages can shift what a later offset lands on. | |
| levelid | No | Charge level ID (1=Low <2kW, 2=Medium >2kW, 3=High >40kW/fast). Array OR-matched. Use 3 as a coarse "fast charging only" filter when a specific connector is not required. | |
| distance | No | Search radius from the center point, in the unit given by distanceUnit (default km). Max 500. Keep small (5-25) for dense urban areas; widen for rural coverage. | |
| latitude | No | Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_search_places first. | |
| longitude | No | Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search. | |
| maxresults | No | Maximum stations to return, ordered by distance from the search point. Max 200; larger positive integers are clamped unless OPENCHARGEMAP_CLAMP_LIMITS=false. | |
| minpowerkw | No | Minimum charging power in kW across any connection at the station. Use ~50 for DC fast charging, ~150 for high-power DC. Stations whose fastest connection is below this are excluded. | |
| operatorid | No | Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category "operators") — e.g. "Tesla", "ChargePoint". | |
| boundingbox | No | Bounding-box search as an alternative to a center+radius. Mutually exclusive with latitude/longitude/distance — sending a boundingbox alongside a latitude or a longitude is rejected, not resolved in favour of one of them. | |
| countrycode | No | Restrict to one country by ISO 3166-1 alpha-2 code (e.g. "US", "FR", "GB"). Omit for a global search. An unrecognized code is not applied; the summary and notice disclose the unrestricted search. Resolve valid codes with openchargemap_lookup_reference (countries). | |
| usagetypeid | No | Usage/access type ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category "usagetypes") — e.g. Public=1, Public-Pay At Location=5, Public-Membership Required=4. | |
| distanceUnit | No | Unit for the distance parameter and the returned distance values. | KM |
| statustypeid | No | Registry operational-status ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category "statustypes"). NOTE: registry status is operator-reported and can be stale — combine with dateLastVerified and openchargemap_get_station_comments to judge real-world reliability, do not treat it as ground truth. | |
| minchargepoints | No | Minimum number of charge points (stalls) at the station. Filters out single-point locations when you need a station likely to have an open stall. | |
| connectiontypeid | No | Connector type ID, or an array of IDs (OR-matched). Resolve names with openchargemap_lookup_reference — e.g. CCS is two IDs, 32 (Type 1, North America) and 33 (Type 2, Europe and most other regions), so pass [32, 33] when the region is unknown; CHAdeMO=2, NACS/Tesla Supercharger=27, Type 2 socket=25, Type 1/J1772=1. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The maxresults cap that was applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Stations in the returned page. | |
| notice | No | How to reach the stations this page left out, or why it came back empty. | |
| stations | No | Matching stations, ordered by distance from the search point. | |
| truncated | No | True when matching stations were left out of the returned page. | |
| nextOffset | No | The offset to pass on an otherwise identical call to read the next page. Absent when nothing further was retrieved. | |
| totalCount | No | Matching stations in the retrieved pool of up to 500 candidates, before offset/maxresults selects the page. Exact when no additional upstream stations remain; otherwise a floor. Stable across pages while the pool remains cached. The notice states whether additional upstream stations exist. | |
| attribution | No | Attribution to Open Charge Map contributors and station data providers; license terms vary by provider. | |
| searchSummary | No | Human-readable echo of the resolved search: location mode, scope, and active filters as the server applied them. |