Server definition
- Hash
- sha256:4514625cd0c728cd3250a5196644af68631a847036085f1c582396f161258719
- What it is
- What a remote MCP server returned when asked what it offers: 4 tools
The blob, as servednamed by its sha256
{
"instructions": "Global EV charging station search over Open Charge Map. Coordinate-native — geocode place names with the openstreetmap server first, then pass coordinates here. Resolve connector/network names to filter IDs with openchargemap_lookup_reference. Registry status is operator-reported and can be stale — corroborate with dateLastVerified and openchargemap_get_station_comments. All station data is © Open Charge Map contributors, licensed under CC BY 4.0 (openchargemap.org); attribution is required in any downstream use.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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.",
"properties": {
"ne_lat": {
"description": "North-east corner latitude.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"ne_lng": {
"description": "North-east corner longitude.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"sw_lat": {
"description": "South-west corner latitude.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"sw_lng": {
"description": "South-west corner longitude.",
"maximum": 180,
"minimum": -180,
"type": "number"
}
},
"required": [
"sw_lat",
"sw_lng",
"ne_lat",
"ne_lng"
],
"type": "object"
},
"connectiontypeid": {
"anyOf": [
{
"description": "A single reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Several reference IDs, OR-matched. At least one.",
"items": {
"description": "A reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
],
"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."
},
"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.",
"maxLength": 2,
"minLength": 2,
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"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.",
"exclusiveMinimum": 0,
"maximum": 500,
"type": "number"
},
"distanceUnit": {
"default": "KM",
"description": "Unit for the distance parameter and the returned distance values.",
"enum": [
"KM",
"Miles"
],
"type": "string"
},
"latitude": {
"description": "Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_geocode first.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"levelid": {
"anyOf": [
{
"description": "A single reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Several reference IDs, OR-matched. At least one.",
"items": {
"description": "A reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
],
"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."
},
"longitude": {
"description": "Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"maxresults": {
"default": 25,
"description": "Maximum stations to return, ordered by distance from the search point. Max 200.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"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.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"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.",
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "number"
},
"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.",
"maximum": 499,
"minimum": 0,
"type": "integer"
},
"operatorid": {
"anyOf": [
{
"description": "A single reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Several reference IDs, OR-matched. At least one.",
"items": {
"description": "A reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
],
"description": "Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category \"operators\") — e.g. \"Tesla\", \"ChargePoint\"."
},
"statustypeid": {
"anyOf": [
{
"description": "A single reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Several reference IDs, OR-matched. At least one.",
"items": {
"description": "A reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
],
"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."
},
"usagetypeid": {
"anyOf": [
{
"description": "A single reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Several reference IDs, OR-matched. At least one.",
"items": {
"description": "A reference ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
],
"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."
}
},
"type": "object"
},
"name": "openchargemap_find_stations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"stations",
"searchSummary",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Required attribution to Open Charge Map contributors under CC BY 4.0.",
"type": "string"
},
"cap": {
"description": "The maxresults cap that was applied.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"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"
},
"searchSummary": {
"description": "Human-readable echo of the resolved search: location mode, scope, and active filters as the server applied them.",
"type": "string"
},
"shown": {
"description": "Stations in the returned page.",
"type": "number"
},
"stations": {
"description": "Matching stations, ordered by distance from the search point.",
"items": {
"additionalProperties": false,
"description": "A charging station record.",
"properties": {
"address": {
"additionalProperties": false,
"description": "Structured station address and coordinates.",
"properties": {
"accessComments": {
"description": "Free-text access notes (e.g. \"24 hours daily\").",
"type": "string"
},
"country": {
"description": "Country name.",
"type": "string"
},
"countryCode": {
"description": "ISO 3166-1 alpha-2 country code.",
"type": "string"
},
"latitude": {
"description": "Station latitude (WGS84).",
"type": "number"
},
"line1": {
"description": "Street address line.",
"type": "string"
},
"longitude": {
"description": "Station longitude (WGS84).",
"type": "number"
},
"postcode": {
"description": "Postal/ZIP code.",
"type": "string"
},
"stateOrProvince": {
"description": "State or province.",
"type": "string"
},
"town": {
"description": "Town or city.",
"type": "string"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"connections": {
"description": "Connectors at the station. Empty when OCM has no connection data on record.",
"items": {
"additionalProperties": false,
"description": "A connector at the station.",
"properties": {
"amps": {
"description": "Rated amperage. Often null.",
"type": [
"number",
"null"
]
},
"connectionType": {
"description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\").",
"type": "string"
},
"connectionTypeId": {
"description": "Connector type ID — resolve via openchargemap_lookup_reference.",
"type": "number"
},
"currentType": {
"description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\").",
"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"
]
},
"quantity": {
"description": "Number of connectors of this type. null when unknown.",
"type": [
"number",
"null"
]
},
"voltage": {
"description": "Rated voltage. Often null.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"dataProvider": {
"description": "Source that provided the listing (e.g. \"afdc.energy.gov\").",
"type": "string"
},
"dateLastVerified": {
"description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified.",
"type": [
"string",
"null"
]
},
"distance": {
"description": "Distance from the search point. Absent for bounding-box searches.",
"type": "number"
},
"distanceUnit": {
"description": "Unit of the distance value.",
"enum": [
"KM",
"Miles"
],
"type": "string"
},
"id": {
"description": "OCM station ID.",
"type": "number"
},
"isAccessKeyRequired": {
"description": "Whether a physical access key is required. 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"
},
"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"
},
"isPayAtLocation": {
"description": "Whether payment is required at the location. Absent when usage type is unknown.",
"type": "boolean"
},
"isRecentlyVerified": {
"description": "Whether the listing was verified recently.",
"type": "boolean"
},
"numberOfPoints": {
"description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero.",
"type": "number"
},
"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"
},
"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"
},
"title": {
"description": "Station name / location title.",
"type": "string"
},
"usageType": {
"description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type.",
"type": "string"
},
"uuid": {
"description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input).",
"type": "string"
}
},
"required": [
"id",
"uuid",
"title",
"address",
"connections"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"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.",
"type": "number"
},
"truncated": {
"description": "True when matching stations were left out of the returned page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "Numeric OCM station ID (e.g. 145452).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"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"
],
"type": "object"
},
"name": "openchargemap_get_station",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station",
"attribution"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Required CC BY 4.0 attribution to Open Charge Map contributors.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"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"
},
"station": {
"additionalProperties": false,
"description": "The full station record.",
"properties": {
"address": {
"additionalProperties": false,
"description": "Structured station address and coordinates.",
"properties": {
"accessComments": {
"description": "Free-text access notes (e.g. \"24 hours daily\").",
"type": "string"
},
"country": {
"description": "Country name.",
"type": "string"
},
"countryCode": {
"description": "ISO 3166-1 alpha-2 country code.",
"type": "string"
},
"latitude": {
"description": "Station latitude (WGS84).",
"type": "number"
},
"line1": {
"description": "Street address line.",
"type": "string"
},
"longitude": {
"description": "Station longitude (WGS84).",
"type": "number"
},
"postcode": {
"description": "Postal/ZIP code.",
"type": "string"
},
"stateOrProvince": {
"description": "State or province.",
"type": "string"
},
"town": {
"description": "Town or city.",
"type": "string"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"comments": {
"description": "Community check-ins, present only when includeComments=true. Empty array means none on record.",
"items": {
"additionalProperties": false,
"description": "A community check-in or comment.",
"properties": {
"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"
},
"commentType": {
"description": "Comment type (e.g. \"General Comment\", \"Fault Report\").",
"type": "string"
},
"dateCreated": {
"description": "ISO 8601 timestamp the comment was posted.",
"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"
},
"user": {
"description": "Commenter username. Absent for anonymous.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"connections": {
"description": "Connectors at the station. Empty when OCM has no connection data on record.",
"items": {
"additionalProperties": false,
"description": "A connector at the station.",
"properties": {
"amps": {
"description": "Rated amperage. Often null.",
"type": [
"number",
"null"
]
},
"connectionType": {
"description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\").",
"type": "string"
},
"connectionTypeId": {
"description": "Connector type ID — resolve via openchargemap_lookup_reference.",
"type": "number"
},
"currentType": {
"description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\").",
"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"
]
},
"quantity": {
"description": "Number of connectors of this type. null when unknown.",
"type": [
"number",
"null"
]
},
"voltage": {
"description": "Rated voltage. Often null.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"dataProvider": {
"description": "Source that provided the listing (e.g. \"afdc.energy.gov\").",
"type": "string"
},
"dataProviderUrl": {
"description": "Source provider website.",
"type": "string"
},
"dateLastStatusUpdate": {
"description": "ISO 8601 timestamp of the last status update.",
"type": [
"string",
"null"
]
},
"dateLastVerified": {
"description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified.",
"type": [
"string",
"null"
]
},
"distance": {
"description": "Distance from the search point. Absent for bounding-box searches.",
"type": "number"
},
"distanceUnit": {
"description": "Unit of the distance value.",
"enum": [
"KM",
"Miles"
],
"type": "string"
},
"generalComments": {
"description": "Operator/free-text notes about the station. Absent when none on record.",
"type": "string"
},
"id": {
"description": "OCM station ID.",
"type": "number"
},
"isAccessKeyRequired": {
"description": "Whether a physical access key is required. 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"
},
"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"
},
"isPayAtLocation": {
"description": "Whether payment is required at the location. Absent when usage type is unknown.",
"type": "boolean"
},
"isRecentlyVerified": {
"description": "Whether the listing was verified recently.",
"type": "boolean"
},
"media": {
"description": "User-submitted photos of the station. Absent when none.",
"items": {
"additionalProperties": false,
"description": "A user-submitted photo.",
"properties": {
"comment": {
"description": "Caption / comment.",
"type": "string"
},
"url": {
"description": "Image URL.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"numberOfPoints": {
"description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero.",
"type": "number"
},
"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"
},
"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"
},
"submissionStatus": {
"description": "OCM submission/publication status (e.g. \"Imported and Published\").",
"type": "string"
},
"title": {
"description": "Station name / location title.",
"type": "string"
},
"usageCost": {
"description": "Free-text cost description (e.g. \"£0.30/kWh\"). Often absent — absence means unknown, not free.",
"type": "string"
},
"usageType": {
"description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type.",
"type": "string"
},
"uuid": {
"description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input).",
"type": "string"
}
},
"required": [
"id",
"uuid",
"title",
"address",
"connections"
],
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "Numeric OCM station ID.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxresults": {
"default": 25,
"description": "Maximum comments to return, newest first. Max 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "openchargemap_get_station_comments",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"stationId",
"stationTitle",
"comments",
"totalComments",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Required CC BY 4.0 attribution to Open Charge Map contributors.",
"type": "string"
},
"cap": {
"description": "The maxresults cap that was applied.",
"type": "number"
},
"comments": {
"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.",
"items": {
"additionalProperties": false,
"description": "A community check-in or comment.",
"properties": {
"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"
},
"commentType": {
"description": "Comment type (e.g. \"General Comment\", \"Fault Report\").",
"type": "string"
},
"dateCreated": {
"description": "ISO 8601 timestamp the comment was posted.",
"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"
},
"user": {
"description": "Commenter username. Absent for anonymous.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"dateLastVerified": {
"description": "ISO 8601 date the listing was last verified. null when never verified.",
"type": [
"string",
"null"
]
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"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"
},
"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"
},
"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"
},
"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"
},
"shown": {
"description": "Comments in the returned page.",
"type": "number"
},
"stationId": {
"description": "OCM station ID the comments belong to.",
"type": "number"
},
"stationTitle": {
"description": "Station name, for context.",
"type": "string"
},
"totalComments": {
"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.",
"type": "number"
},
"totalCount": {
"description": "Comments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size.",
"type": "number"
},
"truncated": {
"description": "True when comments were left out of the returned page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"category": {
"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.",
"enum": [
"connectiontypes",
"operators",
"usagetypes",
"statustypes",
"currenttypes",
"levels",
"countries"
],
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum entries to return when browsing or when a query matches several. Max 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"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.",
"pattern": "\\S",
"type": "string"
}
},
"required": [
"category"
],
"type": "object"
},
"name": "openchargemap_lookup_reference",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"category",
"matches",
"snapshotDate",
"source",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Required CC BY 4.0 attribution to Open Charge Map contributors.",
"type": "string"
},
"cap": {
"description": "The limit that was applied.",
"type": "number"
},
"category": {
"description": "The reference category queried.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"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"
},
"matches": {
"description": "Matching reference entries, best/exact match first.",
"items": {
"additionalProperties": false,
"description": "A matching reference entry.",
"properties": {
"detail": {
"description": "Extra interpretive context (operational flag, pay/membership/access, discontinued/obsolete, continent).",
"type": "string"
},
"formalName": {
"description": "Formal/standard name where applicable. null when none.",
"type": [
"string",
"null"
]
},
"id": {
"description": "The reference ID for this entry.",
"type": "number"
},
"isoCode": {
"description": "ISO 3166-1 alpha-2 code — countries category only.",
"type": "string"
},
"title": {
"description": "Human-readable title (e.g. \"CCS (Type 2)\", \"ChargePoint\", \"United States\").",
"type": "string"
}
},
"required": [
"id",
"title"
],
"type": "object"
},
"type": "array"
},
"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"
},
"shown": {
"description": "Entries in the returned page.",
"type": "number"
},
"snapshotDate": {
"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.",
"type": "string"
},
"source": {
"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.",
"enum": [
"live",
"bundled"
],
"type": "string"
},
"totalCount": {
"description": "Entries matching before the offset/limit page was taken — the whole category when browsing, every match when a query was given.",
"type": "number"
},
"truncated": {
"description": "True when matching entries were left out of the returned page.",
"type": "boolean"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:4514625cd0c728cd3250a5196644af68631a847036085f1c582396f161258719 | sha256sum