openchargemap-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'offset': {'type': 'integer', 'default': 0, 'maximum': 499, 'minimum': 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 â\x80\x94 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': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'A single reference ID.', 'exclusiveMinimum': 0}, {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'A reference ID.', 'exclusiveMinimum': 0}, 'maxItems': 3, 'minItems': 1, 'description': 'Several reference IDs, OR-matched. At least one.'}], '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.'}, 'distance': {'type': 'number', 'default': 25, 'maximum': 500, '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.', 'exclusiveMinimum': 0}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_geocode first.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search.'}, 'maxresults': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum stations to return, ordered by distance from the search point. Max 200.'}, 'minpowerkw': {'type': 'number', 'maximum': 1000, '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.', 'exclusiveMinimum': 0}, 'operatorid': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'A single reference ID.', 'exclusiveMinimum': 0}, {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'A reference ID.', 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'Several reference IDs, OR-matched. At least one.'}], 'description': 'Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category "operators") â\x80\x94 e.g. "Tesla", "ChargePoint".'}, 'boundingbox': {'type': 'object', 'required': ['sw_lat', 'sw_lng', 'ne_lat', 'ne_lng'], 'properties': {'ne_lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'North-east corner latitude.'}, 'ne_lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'North-east corner longitude.'}, 'sw_lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'South-west corner latitude.'}, 'sw_lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'South-west corner longitude.'}}, 'description': 'Bounding-box search as an alternative to a center+radius. Mutually exclusive with latitude/longitude/distance â\x80\x94 sending a boundingbox alongside a latitude or a longitude is rejected, not resolved in favour of one of them.'}, 'countrycode': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'maxLength': 2, 'minLength': 2, '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 â\x80\x94 there is no implicit country.'}, 'usagetypeid': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'A single reference ID.', 'exclusiveMinimum': 0}, {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'A reference ID.', 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'Several reference IDs, OR-matched. At least one.'}], 'description': 'Usage/access type ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category "usagetypes") â\x80\x94 e.g. Public=1, Public-Pay At Location=5, Public-Membership Required=4.'}, 'distanceUnit': {'enum': ['KM', 'Miles'], 'type': 'string', 'default': 'KM', 'description': 'Unit for the distance parameter and the returned distance values.'}, 'statustypeid': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'A single reference ID.', 'exclusiveMinimum': 0}, {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'A reference ID.', 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'Several reference IDs, OR-matched. At least one.'}], '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 â\x80\x94 combine with dateLastVerified and openchargemap_get_station_comments to judge real-world reliability, do not treat it as ground truth.'}, 'minchargepoints': {'type': 'integer', 'maximum': 9007199254740991, '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.', 'exclusiveMinimum': 0}, 'connectiontypeid': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'A single reference ID.', 'exclusiveMinimum': 0}, {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'A reference ID.', 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'Several reference IDs, OR-matched. At least one.'}], 'description': 'Connector type ID, or an array of IDs (OR-matched). Resolve names with openchargemap_lookup_reference â\x80\x94 e.g. CCS (Type 2)=33, CHAdeMO=2, NACS/Tesla Supercharger=27, Type 2 socket=25, Type 1/J1772=1.'}}, 'additionalProperties': False}

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

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric OCM station ID (e.g. 145452).', 'exclusiveMinimum': 0}, 'includeComments': {'type': 'boolean', '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 â\x80\x94 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.'}}, 'additionalProperties': False}

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

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric OCM station ID.', 'exclusiveMinimum': 0}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 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.'}, 'maxresults': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum comments to return, newest first. Max 100.'}}, 'additionalProperties': False}

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

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['category'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum entries to return when browsing or when a query matches several. Max 100.'}, 'query': {'type': 'string', 'pattern': '\\S', '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.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 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.'}, 'category': {'enum': ['connectiontypes', 'operators', 'usagetypes', 'statustypes', 'currenttypes', 'levels', 'countries'], 'type': 'string', '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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['category', 'matches', 'snapshotDate', 'source', 'attribution', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_match'], '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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Entries in the returned page.'}, 'notice': {'type': 'string', 'description': 'How to reach the entries this page left out.'}, 'source': {'enum': ['live', 'bundled'], 'type': 'string', 'description': 'Where these entries came from. "live" â\x80\x94 a startup refresh from Open Charge Map returned a complete set and is what is being served. "bundled" â\x80\x94 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.'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title'], '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").'}, 'detail': {'type': 'string', 'description': 'Extra interpretive context (operational flag, pay/membership/access, discontinued/obsolete, continent).'}, 'isoCode': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 code â\x80\x94 countries category only.'}, 'formalName': {'type': ['string', 'null'], 'description': 'Formal/standard name where applicable. null when none.'}}, 'description': 'A matching reference entry.', 'additionalProperties': False}, 'description': 'Matching reference entries, best/exact match first.'}, 'category': {'type': 'string', 'description': 'The reference category queried.'}, 'truncated': {'type': 'boolean', 'description': 'True when matching entries were left out of the returned page.'}, 'nextOffset': {'type': 'number', 'description': 'The offset to pass on an otherwise identical call to read the next page. Absent on the last page.'}, 'totalCount': {'type': 'number', 'description': 'Entries matching before the offset/limit page was taken â\x80\x94 the whole category when browsing, every match when a query was given.'}, 'attribution': {'type': 'string', 'description': 'Required CC BY 4.0 attribution to Open Charge Map contributors.'}, 'filterParam': {'type': 'string', 'description': 'The find_stations input parameter these IDs feed (e.g. "connectiontypeid"). Omitted for categories with no direct filter (currenttypes; countries use countrycode).'}, 'snapshotDate': {'type': 'string', 'description': 'Date the reference data in this response was captured, so callers know its vintage â\x80\x94 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.'}}, 'additionalProperties': False}