Register for a free API key at openchargemap.io; while some read operations work without a key, using one increases rate limits and is required for write operations
Call the core POI (point of interest) endpoint: GET https://api.openchargemap.io/v3/poi/ with query parameters latitude, longitude, and distance (in km or miles per distanceunit parameter) to get nearby stations
Filter results using additional parameters: countrycode (ISO 3166-1 alpha-2), connectiontypeid, statustypeid (operational status), or levelid (charging level) to narrow results
Parse the JSON array response; each POI object contains AddressInfo (location, address), Connections (connector types and power levels), StatusType, and OperatorInfo fields
For reference data (connector type IDs, network operator IDs, status type IDs), call GET /v3/referencedata once and cache the result; these lists change infrequently
Known gotchas
Open Charge Map data is community-contributed and quality varies significantly by region; always display a data source attribution and do not assume operational status is real-time — it reflects the last community update
The distance filter is a bounding radius but results are not guaranteed to be sorted by distance unless you add compact=true or sort client-side; large radius queries can return thousands of results
The API returns verbose nested objects by default; use the compact=true parameter to get slimmer responses if you only need basic location and connector type information, reducing payload size significantly
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp