openchargemap-mcp-server

Find 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_geocode 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 ID with openchargemap_lookup_reference (e.g. "CCS" -> 33). 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.

{
  "type": "object",
  "properties": {
    "latitude": {
      "description": "Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_geocode first.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "description": "Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "distance": {
      "default": 25,
      "description": "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.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 500
    },
    "distanceUnit": {
      "default": "KM",
      "description": "Unit for the distance parameter and the returned distance values.",
      "type": "string",
      "enum": [
        "KM",
        "Miles"
      ]
    },
    "boundingbox": {
      "description": "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.",
      "type": "object",
      "properties": {
        "sw_lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "South-west corner latitude."
        },
        "sw_lng": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "South-west corner longitude."
        },
        "ne_lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "North-east corner latitude."
        },
        "ne_lng": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "North-east corner longitude."
        }
      },
      "required": [
        "sw_lat",
        "sw_lng",
        "ne_lat",
        "ne_lng"
      ]
    },
    "countrycode": {
      "description": "Restrict to one country by ISO 3166-1 alpha-2 code (e.g. \"US\", \"FR\", \"GB\"). Omit for a global search. The server is global by default — there is no implicit country.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$"
    },
    "connectiontypeid": {
      "description": "Connector type ID, or an array of IDs (OR-matched). Resolve names with openchargemap_lookup_reference — e.g. CCS (Type 2)=33, CHAdeMO=2, NACS/Tesla Supercharger=27, Type 2 socket=25, Type 1/J1772=1.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "A single reference ID."
        },
        {
          "minItems": 1,
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "A reference ID."
          },
          "description": "Several reference IDs, OR-matched. At least one."
        }
      ]
    },
    "minpowerkw": {
      "description": "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.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "operatorid": {
      "description": "Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category \"operators\") — e.g. \"Tesla\", \"ChargePoint\".",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "A single reference ID."
        },
        {
          "minItems": 1,
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "A reference ID."
          },
          "description": "Several reference IDs, OR-matched. At least one."
        }
      ]
    },
    "usagetypeid": {
      "description": "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.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "A single reference ID."
        },
        {
          "minItems": 1,
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "A reference ID."
          },
          "description": "Several reference IDs, OR-matched. At least one."
        }
      ]
    },
    "levelid": {
      "description": "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.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "A single reference ID."
        },
        {
          "minItems": 1,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "A reference ID."
          },
          "description": "Several reference IDs, OR-matched. At least one."
        }
      ]
    },
    "statustypeid": {
      "description": "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.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "A single reference ID."
        },
        {
          "minItems": 1,
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "A reference ID."
          },
          "description": "Several reference IDs, OR-matched. At least one."
        }
      ]
    },
    "minchargepoints": {
      "description": "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.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "maxresults": {
      "default": 25,
      "description": "Maximum stations to return, ordered by distance from the search point. Max 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "default": 0,
      "description": "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.",
      "type": "integer",
      "minimum": 0,
      "maximum": 499
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "stations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "OCM station ID."
          },
          "uuid": {
            "type": "string",
            "description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input)."
          },
          "title": {
            "type": "string",
            "description": "Station name / location title."
          },
          "address": {
            "type": "object",
            "properties": {
              "line1": {
                "description": "Street address line.",
                "type": "string"
              },
              "town": {
                "description": "Town or city.",
                "type": "string"
              },
              "stateOrProvince": {
                "description": "State or province.",
                "type": "string"
              },
              "postcode": {
                "description": "Postal/ZIP code.",
                "type": "string"
              },
              "country": {
                "description": "Country name.",
                "type": "string"
              },
              "countryCode": {
                "description": "ISO 3166-1 alpha-2 country code.",
                "type": "string"
              },
              "latitude": {
                "type": "number",
                "description": "Station latitude (WGS84)."
              },
              "longitude": {
                "type": "number",
                "description": "Station longitude (WGS84)."
              },
              "accessComments": {
                "description": "Free-text access notes (e.g. \"24 hours daily\").",
                "type": "string"
              }
            },
            "required": [
              "latitude",
              "longitude"
            ],
            "additionalProperties": false,
            "description": "Structured station address and coordinates."
          },
          "distance": {
            "description": "Distance from the search point. Absent for bounding-box searches.",
            "type": "number"
          },
          "distanceUnit": {
            "description": "Unit of the distance value.",
            "type": "string",
            "enum": [
              "KM",
              "Miles"
            ]
          },
          "operator": {
            "description": "Operating network name (e.g. \"ChargePoint\", \"Tesla\"). Absent when OCM has no operator on record.",
            "type": "string"
          },
          "operatorId": {
            "description": "OCM operator ID — resolve names via openchargemap_lookup_reference.",
            "type": "number"
          },
          "usageType": {
            "description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type.",
            "type": "string"
          },
          "isPayAtLocation": {
            "description": "Whether payment is required at the location. Absent when usage type is unknown.",
            "type": "boolean"
          },
          "isMembershipRequired": {
            "description": "Whether a membership or RFID card is required. Absent when usage type is unknown.",
            "type": "boolean"
          },
          "isAccessKeyRequired": {
            "description": "Whether a physical access key is required. Absent when usage type is unknown.",
            "type": "boolean"
          },
          "numberOfPoints": {
            "description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero.",
            "type": "number"
          },
          "status": {
            "description": "Registry operational status (e.g. \"Operational\", \"Temporarily Unavailable\"). Operator-reported; may be stale.",
            "type": "string"
          },
          "statusTypeId": {
            "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.",
            "type": "number"
          },
          "isOperational": {
            "description": "Whether the registry marks the status operational. Absent when the operational state is unknown. A true value can still mask a broken charger — corroborate with comments and dateLastVerified.",
            "type": "boolean"
          },
          "dateLastVerified": {
            "description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified.",
            "type": [
              "string",
              "null"
            ]
          },
          "isRecentlyVerified": {
            "description": "Whether the listing was verified recently.",
            "type": "boolean"
          },
          "connections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "connectionTypeId": {
                  "description": "Connector type ID — resolve via openchargemap_lookup_reference.",
                  "type": "number"
                },
                "connectionType": {
                  "description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\").",
                  "type": "string"
                },
                "level": {
                  "description": "Charge level title (e.g. \"Level 2 : Medium (Over 2kW)\").",
                  "type": "string"
                },
                "levelId": {
                  "description": "Charge level ID (1/2/3).",
                  "type": "number"
                },
                "powerKW": {
                  "description": "Rated power in kW for this connection. null/absent when unknown.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "currentType": {
                  "description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\").",
                  "type": "string"
                },
                "amps": {
                  "description": "Rated amperage. Often null.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "voltage": {
                  "description": "Rated voltage. Often null.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "quantity": {
                  "description": "Number of connectors of this type. null when unknown.",
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "additionalProperties": false,
              "description": "A connector at the station."
            },
            "description": "Connectors at the station. Empty when OCM has no connection data on record."
          },
          "dataProvider": {
            "description": "Source that provided the listing (e.g. \"afdc.energy.gov\").",
            "type": "string"
          }
        },
        "required": [
          "id",
          "uuid",
          "title",
          "address",
          "connections"
        ],
        "additionalProperties": false,
        "description": "A charging station record."
      },
      "description": "Matching stations, ordered by distance from the search point."
    },
    "searchSummary": {
      "type": "string",
      "description": "Human-readable echo of the resolved search: location mode, scope, and active filters as the server applied them."
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution to Open Charge Map contributors under CC BY 4.0."
    },
    "totalCount": {
      "type": "number",
      "description": "Matching stations this search retrieved, before the offset/maxresults page was taken. Open Charge Map publishes no match total and one search can only retrieve so deep, so this is exact only when the search reached the end of what Open Charge Map holds for the area — otherwise it is a floor that rises as deeper pages are read. The notice says which of the two applies."
    },
    "truncated": {
      "description": "True when matching stations were left out of the returned page.",
      "type": "boolean"
    },
    "shown": {
      "description": "Stations in the returned page.",
      "type": "number"
    },
    "cap": {
      "description": "The maxresults cap that was applied.",
      "type": "number"
    },
    "nextOffset": {
      "description": "The offset to pass on an otherwise identical call to read the next page. Absent when nothing further was retrieved.",
      "type": "number"
    },
    "notice": {
      "description": "How to reach the stations this page left out, or why it came back empty.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `invalid_location`: No search area was provided; or only one half of a center arrived; or a boundingbox arrived alongside a latitude or a longitude. `no_stations`: Open Charge Map holds no station for the search area and filters — either it returned nothing at all, or every station it returned was ruled out and there were no further candidates. `upstream_unavailable`: OCM returned a non-2xx response or timed out. `auth_failed`: OCM returned HTTP 401 or 403 — the API key is missing or invalid. Other values are possible when a failure originates below the handler.",
              "examples": [
                "invalid_location",
                "no_stations",
                "upstream_unavailable",
                "auth_failed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "stations",
        "searchSummary",
        "attribution",
        "totalCount"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Get the full record for one Open Charge Map station by its numeric OCM ID. Returns every connection (type, level, power, current, quantity, per-connection status), the operator and network, usage and access restrictions (pay-at-location, membership, access key), the number of charge points, general comments, usage cost, the data provider, media, and verification recency. Set includeComments to also return community check-ins inline.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric OCM station ID (e.g. 145452)."
    },
    "includeComments": {
      "default": false,
      "description": "Include community check-ins and comments inline in the response. Adds payload but gives the real-world reliability signal alongside the registry status. Every comment on record comes back at once, unpaged — on a station with hundreds of check-ins that is a large response, so prefer openchargemap_get_station_comments, which returns them a page at a time.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "station": {
      "type": "object",
      "properties": {
        "id": {
          "type": "number",
          "description": "OCM station ID."
        },
        "uuid": {
          "type": "string",
          "description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input)."
        },
        "title": {
          "type": "string",
          "description": "Station name / location title."
        },
        "address": {
          "type": "object",
          "properties": {
            "line1": {
              "description": "Street address line.",
              "type": "string"
            },
            "town": {
              "description": "Town or city.",
              "type": "string"
            },
            "stateOrProvince": {
              "description": "State or province.",
              "type": "string"
            },
            "postcode": {
              "description": "Postal/ZIP code.",
              "type": "string"
            },
            "country": {
              "description": "Country name.",
              "type": "string"
            },
            "countryCode": {
              "description": "ISO 3166-1 alpha-2 country code.",
              "type": "string"
            },
            "latitude": {
              "type": "number",
              "description": "Station latitude (WGS84)."
            },
            "longitude": {
              "type": "number",
              "description": "Station longitude (WGS84)."
            },
            "accessComments": {
              "description": "Free-text access notes (e.g. \"24 hours daily\").",
              "type": "string"
            }
          },
          "required": [
            "latitude",
            "longitude"
          ],
          "additionalProperties": false,
          "description": "Structured station address and coordinates."
        },
        "distance": {
          "description": "Distance from the search point. Absent for bounding-box searches.",
          "type": "number"
        },
        "distanceUnit": {
          "description": "Unit of the distance value.",
          "type": "string",
          "enum": [
            "KM",
            "Miles"
          ]
        },
        "operator": {
          "description": "Operating network name (e.g. \"ChargePoint\", \"Tesla\"). Absent when OCM has no operator on record.",
          "type": "string"
        },
        "operatorId": {
          "description": "OCM operator ID — resolve names via openchargemap_lookup_reference.",
          "type": "number"
        },
        "usageType": {
          "description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type.",
          "type": "string"
        },
        "isPayAtLocation": {
          "description": "Whether payment is required at the location. Absent when usage type is unknown.",
          "type": "boolean"
        },
        "isMembershipRequired": {
          "description": "Whether a membership or RFID card is required. Absent when usage type is unknown.",
          "type": "boolean"
        },
        "isAccessKeyRequired": {
          "description": "Whether a physical access key is required. Absent when usage type is unknown.",
          "type": "boolean"
        },
        "numberOfPoints": {
          "description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero.",
          "type": "number"
        },
        "status": {
          "description": "Registry operational status (e.g. \"Operational\", \"Temporarily Unavailable\"). Operator-reported; may be stale.",
          "type": "string"
        },
        "statusTypeId": {
          "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.",
          "type": "number"
        },
        "isOperational": {
          "description": "Whether the registry marks the status operational. Absent when the operational state is unknown. A true value can still mask a broken charger — corroborate with comments and dateLastVerified.",
          "type": "boolean"
        },
        "dateLastVerified": {
          "description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified.",
          "type": [
            "string",
            "null"
          ]
        },
        "isRecentlyVerified": {
          "description": "Whether the listing was verified recently.",
          "type": "boolean"
        },
        "connections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "connectionTypeId": {
                "description": "Connector type ID — resolve via openchargemap_lookup_reference.",
                "type": "number"
              },
              "connectionType": {
                "description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\").",
                "type": "string"
              },
              "level": {
                "description": "Charge level title (e.g. \"Level 2 : Medium (Over 2kW)\").",
                "type": "string"
              },
              "levelId": {
                "description": "Charge level ID (1/2/3).",
                "type": "number"
              },
              "powerKW": {
                "description": "Rated power in kW for this connection. null/absent when unknown.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "currentType": {
                "description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\").",
                "type": "string"
              },
              "amps": {
                "description": "Rated amperage. Often null.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "voltage": {
                "description": "Rated voltage. Often null.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "quantity": {
                "description": "Number of connectors of this type. null when unknown.",
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "additionalProperties": false,
            "description": "A connector at the station."
          },
          "description": "Connectors at the station. Empty when OCM has no connection data on record."
        },
        "dataProvider": {
          "description": "Source that provided the listing (e.g. \"afdc.energy.gov\").",
          "type": "string"
        },
        "generalComments": {
          "description": "Operator/free-text notes about the station. Absent when none on record.",
          "type": "string"
        },
        "usageCost": {
          "description": "Free-text cost description (e.g. \"£0.30/kWh\"). Often absent — absence means unknown, not free.",
          "type": "string"
        },
        "dataProviderUrl": {
          "description": "Source provider website.",
          "type": "string"
        },
        "dateLastStatusUpdate": {
          "description": "ISO 8601 timestamp of the last status update.",
          "type": [
            "string",
            "null"
          ]
        },
        "submissionStatus": {
          "description": "OCM submission/publication status (e.g. \"Imported and Published\").",
          "type": "string"
        },
        "media": {
          "description": "User-submitted photos of the station. Absent when none.",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Image URL."
              },
              "comment": {
                "description": "Caption / comment.",
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false,
            "description": "A user-submitted photo."
          }
        },
        "comments": {
          "description": "Community check-ins, present only when includeComments=true. Empty array means none on record.",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "user": {
                "description": "Commenter username. Absent for anonymous.",
                "type": "string"
              },
              "commentType": {
                "description": "Comment type (e.g. \"General Comment\", \"Fault Report\").",
                "type": "string"
              },
              "checkinStatus": {
                "description": "The visit outcome the driver recorded (e.g. \"Charged Successfully\", \"Failed to Charge (Equipment Not Operational)\"). Carries the result on check-ins that have no comment text. Absent when the visitor recorded no outcome.",
                "type": "string"
              },
              "checkinStatusId": {
                "description": "Numeric ID of the check-in outcome, stable across renames of its title.",
                "type": "number"
              },
              "checkinStatusIsPositive": {
                "description": "Whether the registry classes this outcome as a good visit. Absent when the outcome carries no verdict either way (e.g. \"Did Not Visit Location\") or when none was recorded.",
                "type": "boolean"
              },
              "comment": {
                "description": "Comment text.",
                "type": "string"
              },
              "rating": {
                "description": "User rating 1–5. null when not given.",
                "type": [
                  "number",
                  "null"
                ]
              },
              "relatedUrl": {
                "description": "Link the commenter attached. Absent when none was given.",
                "type": "string"
              },
              "dateCreated": {
                "description": "ISO 8601 timestamp the comment was posted.",
                "type": "string"
              }
            },
            "additionalProperties": false,
            "description": "A community check-in or comment."
          }
        }
      },
      "required": [
        "id",
        "uuid",
        "title",
        "address",
        "connections"
      ],
      "additionalProperties": false,
      "description": "The full station record."
    },
    "reliabilityNote": {
      "description": "A caveat when the registry status, verification age, coordinates, or comments suggest the listing may not reflect reality. Omitted when there is nothing to flag.",
      "type": "string"
    },
    "attribution": {
      "type": "string",
      "description": "Required CC BY 4.0 attribution to Open Charge Map contributors."
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `not_found`: OCM returned an empty result for the given numeric ID (HTTP 200 with []) — no such station. `upstream_unavailable`: OCM returned a non-2xx response or timed out. `auth_failed`: OCM returned HTTP 401 or 403 — the API key is missing or invalid. Other values are possible when a failure originates below the handler.",
              "examples": [
                "not_found",
                "upstream_unavailable",
                "auth_failed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "station",
        "attribution"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Resolve Open Charge Map reference data to the integer IDs that openchargemap_find_stations filters require. Pick a category and pass a name or code to resolve — "CCS" or "Tesla Supercharger" -> a connectiontypeid, "ChargePoint" -> an operatorid, "Public - Pay At Location" -> a usagetypeid, "France" or "FR" -> a country. Omit the query to browse the whole category. Large categories come back one page at a time: when a page reports truncated, repeat the call with the reported nextOffset to read the next one.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "connectiontypes",
        "operators",
        "usagetypes",
        "statustypes",
        "currenttypes",
        "levels",
        "countries"
      ],
      "description": "Which reference set to query. connectiontypes -> connectiontypeid; operators -> operatorid; usagetypes -> usagetypeid; statustypes -> statustypeid; currenttypes -> current type; levels -> charge level (1/2/3); countries -> ISO country."
    },
    "query": {
      "description": "Name, title, code, or alias to resolve (e.g. \"CCS\", \"CHAdeMO\", \"Tesla\", \"Public\", \"France\", \"FR\"). Case-insensitive, matches on title, formal name, and known aliases. Omit to browse the entire category.",
      "type": "string",
      "pattern": "\\S"
    },
    "limit": {
      "default": 25,
      "description": "Maximum entries to return when browsing or when a query matches several. Max 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Entries to skip before the returned page, for reading past a truncated result. Repeat the same call with the nextOffset value the previous one reported. Applies to browsing and to a query with many matches alike; the order is stable, so every entry is reachable by paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "The reference category queried."
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "The reference ID for this entry."
          },
          "title": {
            "type": "string",
            "description": "Human-readable title (e.g. \"CCS (Type 2)\", \"ChargePoint\", \"United States\")."
          },
          "formalName": {
            "description": "Formal/standard name where applicable. null when none.",
            "type": [
              "string",
              "null"
            ]
          },
          "isoCode": {
            "description": "ISO 3166-1 alpha-2 code — countries category only.",
            "type": "string"
          },
          "detail": {
            "description": "Extra interpretive context (operational flag, pay/membership/access, discontinued/obsolete, continent).",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title"
        ],
        "additionalProperties": false,
        "description": "A matching reference entry."
      },
      "description": "Matching reference entries, best/exact match first."
    },
    "filterParam": {
      "description": "The find_stations input parameter these IDs feed (e.g. \"connectiontypeid\"). Omitted for categories with no direct filter (currenttypes; countries use countrycode).",
      "type": "string"
    },
    "snapshotDate": {
      "type": "string",
      "description": "Date the reference data in this response was captured, so callers know its vintage — the day the live refresh ran when source is \"live\", the bundled snapshot's own capture date when source is \"bundled\". Read it together with source: the same date can mean either a fresh fetch or a freshly cut bundle."
    },
    "source": {
      "type": "string",
      "enum": [
        "live",
        "bundled"
      ],
      "description": "Where these entries came from. \"live\" — a startup refresh from Open Charge Map returned a complete set and is what is being served. \"bundled\" — the snapshot shipped with the server is being served, either because the refresh is switched off or because it failed and the server fell back to the bundle."
    },
    "attribution": {
      "type": "string",
      "description": "Required CC BY 4.0 attribution to Open Charge Map contributors."
    },
    "totalCount": {
      "type": "number",
      "description": "Entries matching before the offset/limit page was taken — the whole category when browsing, every match when a query was given."
    },
    "truncated": {
      "description": "True when matching entries were left out of the returned page.",
      "type": "boolean"
    },
    "shown": {
      "description": "Entries in the returned page.",
      "type": "number"
    },
    "cap": {
      "description": "The limit that was applied.",
      "type": "number"
    },
    "nextOffset": {
      "description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page.",
      "type": "number"
    },
    "notice": {
      "description": "How to reach the entries this page left out.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `no_match`: No reference entry in the category matched the query. Other values are possible when a failure originates below the handler.",
              "examples": [
                "no_match"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "category",
        "matches",
        "snapshotDate",
        "source",
        "attribution",
        "totalCount"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Read community check-ins and comments for one Open Charge Map station — the real-world reliability signal beyond the operator-reported registry status. Returns user comments and fault reports with ratings, dates, and the outcome the driver recorded ("Charged Successfully", "Failed to Charge (Equipment Not Operational)", …), alongside the station's current registry status and last-verified date, surfacing mismatches like "listed operational, but the last few check-ins report a fault." A busy station's check-ins come back one page at a time: when a page reports truncated, repeat the call with the reported nextOffset to read the next one.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric OCM station ID."
    },
    "maxresults": {
      "default": 25,
      "description": "Maximum comments to return, newest first. Max 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Comments to skip before the returned page, for reading past a truncated result. Repeat the same call with the nextOffset value the previous one reported. Ordering is newest-first and stable, but a check-in posted between pages shifts what a later offset lands on.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "stationId": {
      "type": "number",
      "description": "OCM station ID the comments belong to."
    },
    "stationTitle": {
      "type": "string",
      "description": "Station name, for context."
    },
    "registryStatus": {
      "description": "Current registry operational status (operator-reported).",
      "type": "string"
    },
    "registryStatusId": {
      "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.",
      "type": "number"
    },
    "isOperational": {
      "description": "Whether the registry marks the station operational. Absent when the operational state is unknown. Compare against the comments below — they are the real-world check.",
      "type": "boolean"
    },
    "dateLastVerified": {
      "description": "ISO 8601 date the listing was last verified. null when never verified.",
      "type": [
        "string",
        "null"
      ]
    },
    "comments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "user": {
            "description": "Commenter username. Absent for anonymous.",
            "type": "string"
          },
          "commentType": {
            "description": "Comment type (e.g. \"General Comment\", \"Fault Report\").",
            "type": "string"
          },
          "checkinStatus": {
            "description": "The visit outcome the driver recorded (e.g. \"Charged Successfully\", \"Failed to Charge (Equipment Not Operational)\"). Carries the result on check-ins that have no comment text. Absent when the visitor recorded no outcome.",
            "type": "string"
          },
          "checkinStatusId": {
            "description": "Numeric ID of the check-in outcome, stable across renames of its title.",
            "type": "number"
          },
          "checkinStatusIsPositive": {
            "description": "Whether the registry classes this outcome as a good visit. Absent when the outcome carries no verdict either way (e.g. \"Did Not Visit Location\") or when none was recorded.",
            "type": "boolean"
          },
          "comment": {
            "description": "Comment text.",
            "type": "string"
          },
          "rating": {
            "description": "User rating 1–5. null when not given.",
            "type": [
              "number",
              "null"
            ]
          },
          "relatedUrl": {
            "description": "Link the commenter attached. Absent when none was given.",
            "type": "string"
          },
          "dateCreated": {
            "description": "ISO 8601 timestamp the comment was posted.",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "description": "A community check-in or comment."
      },
      "description": "The requested page of community comments, newest first — offset/maxresults applied. Empty with totalComments 0 means OCM has no check-ins for this station (absence of reports is not evidence the charger works); empty with a non-zero totalComments means the offset is past the last comment."
    },
    "totalComments": {
      "type": "number",
      "description": "Comments this station has on record — the whole set, before offset/maxresults selected the page in comments. reliabilityNote counts its fault ratio over this population, not over the page."
    },
    "reliabilityNote": {
      "description": "A caveat when the registry status, verification age, coordinates, or comments suggest the listing may not reflect reality. Omitted when there is nothing to flag.",
      "type": "string"
    },
    "attribution": {
      "type": "string",
      "description": "Required CC BY 4.0 attribution to Open Charge Map contributors."
    },
    "totalCount": {
      "type": "number",
      "description": "Comments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size."
    },
    "truncated": {
      "description": "True when comments were left out of the returned page.",
      "type": "boolean"
    },
    "shown": {
      "description": "Comments in the returned page.",
      "type": "number"
    },
    "cap": {
      "description": "The maxresults cap that was applied.",
      "type": "number"
    },
    "nextOffset": {
      "description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page.",
      "type": "number"
    },
    "notice": {
      "description": "How to reach the comments this page left out, or why the station has none on record.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `not_found`: OCM returned an empty result for the given numeric ID (HTTP 200 with []) — no such station. `upstream_unavailable`: OCM returned a non-2xx response or timed out. `auth_failed`: OCM returned HTTP 401 or 403 — the API key is missing or invalid. Other values are possible when a failure originates below the handler.",
              "examples": [
                "not_found",
                "upstream_unavailable",
                "auth_failed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "stationId",
        "stationTitle",
        "comments",
        "totalComments",
        "attribution",
        "totalCount"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}