openchargemap-mcp-server
Server Details
Find EV charging stations, detail, and reliability check-ins via the global Open Charge Map.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- cyanheads/openchargemap-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/openchargemap-mcp-server
Available Tools
4 toolsopenchargemap_find_stationsopenchargemap-mcp-server: find stationsARead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | Matching stations to skip before the returned page, for reading past a truncated result. Repeat the same search with the nextOffset value the previous call reported. One search reaches at most 500 stations, so 499 is the deepest offset that can return one — narrow the area or add filters to reach stations beyond that. Ordering is by distance and stable, but Open Charge Map is edited continuously, so a station added or removed between pages can shift what a later offset lands on. | |
| levelid | No | Charge level ID (1=Low <2kW, 2=Medium >2kW, 3=High >40kW/fast). Array OR-matched. Use 3 as a coarse "fast charging only" filter when a specific connector is not required. | |
| distance | No | Search radius from the center point, in the unit given by distanceUnit (default km). Max 500. Keep small (5-25) for dense urban areas; widen for rural coverage. | |
| latitude | No | Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_geocode first. | |
| longitude | No | Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search. | |
| maxresults | No | Maximum stations to return, ordered by distance from the search point. Max 200. | |
| minpowerkw | No | Minimum charging power in kW across any connection at the station. Use ~50 for DC fast charging, ~150 for high-power DC. Stations whose fastest connection is below this are excluded. | |
| operatorid | No | Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category "operators") — e.g. "Tesla", "ChargePoint". | |
| boundingbox | No | Bounding-box search as an alternative to a center+radius. Mutually exclusive with latitude/longitude/distance — sending a boundingbox alongside a latitude or a longitude is rejected, not resolved in favour of one of them. | |
| countrycode | No | Restrict to one country by ISO 3166-1 alpha-2 code (e.g. "US", "FR", "GB"). Omit for a global search. The server is global by default — there is no implicit country. | |
| usagetypeid | No | Usage/access type ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category "usagetypes") — e.g. Public=1, Public-Pay At Location=5, Public-Membership Required=4. | |
| distanceUnit | No | Unit for the distance parameter and the returned distance values. | KM |
| statustypeid | No | Registry operational-status ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category "statustypes"). NOTE: registry status is operator-reported and can be stale — combine with dateLastVerified and openchargemap_get_station_comments to judge real-world reliability, do not treat it as ground truth. | |
| minchargepoints | No | Minimum number of charge points (stalls) at the station. Filters out single-point locations when you need a station likely to have an open stall. | |
| connectiontypeid | No | Connector type ID, or an array of IDs (OR-matched). Resolve names with openchargemap_lookup_reference — e.g. CCS (Type 2)=33, CHAdeMO=2, NACS/Tesla Supercharger=27, Type 2 socket=25, Type 1/J1772=1. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cap | No | The maxresults cap that was applied. |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Stations in the returned page. |
| notice | No | How to reach the stations this page left out, or why it came back empty. |
| stations | No | Matching stations, ordered by distance from the search point. |
| truncated | No | True when matching stations were left out of the returned page. |
| nextOffset | No | The offset to pass on an otherwise identical call to read the next page. Absent when nothing further was retrieved. |
| totalCount | No | Matching stations 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. |
| attribution | No | Required attribution to Open Charge Map contributors under CC BY 4.0. |
| searchSummary | No | Human-readable echo of the resolved search: location mode, scope, and active filters as the server applied them. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true and openWorldHint=true, but the description adds substantial behavioral context: the registry is continuously edited so pagination offsets may shift, operational status is operator-reported and can be stale (recommending combination with dateLastVerified and comments), and boundingbox is mutually exclusive with latitude/longitude (rejected, not resolved). It also discloses the 500-station maximum. These details go well beyond the annotations and prepare the agent for real-world variability.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is longer than typical but every sentence earns its place: it front-loads the core action, then covers coordinate requirement, filter types, ID resolution, result fields, and pagination in a logical order. It avoids repetition and fluff, though it could be slightly trimmed without losing value. Still, it is well-structured and readable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 15-parameter tool with multiple search modes, filtering, and pagination, the description is exhaustive: it explains both search patterns, emphasizes the coordinate-native limitation, details the filter ID resolution, describes result contents, and covers pagination with offset behavior and staleness caveats. The presence of an output schema covers return structure, so nothing essential is missing for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so every parameter already has detailed semantics (e.g., distance max 500, levelid meaning, minpowerkw thresholds). The tool description only lists filter categories without adding new parameter-specific guidance beyond what the schema provides. It meets the baseline for a fully documented schema but does not elevate it; no extra insight like practical usage patterns beyond the schema's own examples.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb ('Find') and resource ('EV charging stations from the global Open Charge Map registry'), then immediately scopes the search modes (point/radius or bounding box) and optional country filter. It clearly distinguishes itself from sibling tools by being the station finder, while get_station fetches a single station, get_station_comments fetches comments, and lookup_reference resolves IDs. No ambiguity about what this tool does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use this tool and what to do beforehand: it does not geocode place names, so it instructs to resolve coordinates with openstreetmap_geocode first. It also directs users to resolve filter IDs via openchargemap_lookup_reference, and explains pagination (repeat with nextOffset for truncated results). This gives clear decision criteria and alternative usage, far beyond a generic 'use this for stations' statement.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
openchargemap_get_stationopenchargemap-mcp-server: get stationARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric OCM station ID (e.g. 145452). | |
| includeComments | No | 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. |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| station | No | The full station record. |
| attribution | No | Required CC BY 4.0 attribution to Open Charge Map contributors. |
| reliabilityNote | No | 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. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already provide readOnlyHint, openWorldHint, and idempotentHint, covering safety and idempotency. The description adds behavioral context beyond annotations: it discloses that includeComments returns all comments unpaged and can produce a large response, explicitly warning about payload size and recommending the paginated alternative. This extra disclosure of a non-obvious behavior (unpaged, potentially huge) goes beyond the annotations and is valuable for the agent's decision-making. No contradiction with annotations detected.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with its purpose, then lists the returned fields concisely, and ends with the optional parameter note. It's informational without redundancy, though the enumeration of field groups is somewhat lengthy. Every sentence contributes to understanding what the tool returns or how to use it. It's structured well, not verbose to the point of distraction, so a 4 is appropriate.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-station retrieval tool with a rich output schema (has output schema: true), the description sufficiently explains what is returned (full record fields) and the optional comment inclusion behavior, including the warning about payload size and the alternative. It covers all key aspects a caller needs: identifier, optional flag, and behavioral nuance. The presence of an output schema means return structure details are not the description's job. No significant missing pieces for this moderate-complexity tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% — both 'id' and 'includeComments' have clear descriptions in the input schema. The description text itself reiterates the includeComments behavior ('Set includeComments to also return community check-ins inline') but adds no new semantics beyond the schema, which already explains the unpaged nature and suggests the sibling tool. Since the schema fully covers parameter meaning, the baseline of 3 applies; the description provides no additional value over schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description uses the specific verb 'get' with a clear resource ('full record for one Open Charge Map station') and a precise identifier ('numeric OCM ID'). It enumerates exactly what is returned (connections, operator, access restrictions, cost, etc.), distinguishing it from siblings like openchargemap_get_station_comments (which focuses on comments) and openchargemap_find_stations (search). The purpose is unambiguous and fully differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description and includeComments parameter explicitly state when to use the alternative tool: 'prefer openchargemap_get_station_comments, which returns them a page at a time.' It effectively tells the agent that for a full station record, this tool is appropriate, and for paginated comments, use the sibling. However, it does not explicitly contrast with find_stations (search vs single-record) beyond the obvious purpose, which is implicitly clear from the purpose statement. Still, the guidance for the main alternative is explicit, earning a high score but not perfect.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
openchargemap_get_station_commentsopenchargemap-mcp-server: get station commentsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric OCM station ID. | |
| offset | No | 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 | No | Maximum comments to return, newest first. Max 100. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cap | No | The maxresults cap that was applied. |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Comments in the returned page. |
| notice | No | How to reach the comments this page left out, or why the station has none on record. |
| comments | No | 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. |
| stationId | No | OCM station ID the comments belong to. |
| truncated | No | True when comments were left out of the returned page. |
| nextOffset | No | The offset to pass on an otherwise identical call to read the next page. Absent on the last page. |
| totalCount | No | Comments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size. |
| attribution | No | Required CC BY 4.0 attribution to Open Charge Map contributors. |
| stationTitle | No | Station name, for context. |
| isOperational | No | 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. |
| totalComments | No | 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. |
| registryStatus | No | Current registry operational status (operator-reported). |
| reliabilityNote | No | 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 | No | ISO 8601 date the listing was last verified. null when never verified. |
| registryStatusId | No | Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover readOnly, idempotent, and openWorld hints, so the safety profile is known. The description adds valuable behavioral context beyond that: it states the response contains user comments and fault reports with specific outcome values, alongside registry status and last-verified date, and explains pagination semantics ('a page reports truncated', 'repeat with nextOffset') and ordering ('newest-first'). No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences, with the core purpose front-loaded in the first sentence. The second sentence summarizes the output content without unnecessary elaboration, and the third covers pagination concisely. There is no fluff or repetition; every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (3 params, one required), existing output schema, and annotations covering safety, the description provides everything needed to call it correctly: purpose, output content, pagination handling, and ordering. The output schema will document return values, so nothing critical is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for all three parameters, so the schema already fully documents `id`, `offset`, and `maxresults` including defaults and maximums. The description does not add new parameter-level details beyond what the schema provides; it reinforces the offset pagination behavior but does not extend beyond it. Per the rubric, a baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Read') and a clear resource ('community check-ins and comments for one Open Charge Map station'), and immediately differentiates itself from siblings by framing it as 'the real-world reliability signal beyond the operator-reported registry status.' An agent can unmistakably identify this as the tool for retrieving user comments for a specific station, distinct from find_stations (search), get_station (registry details), and lookup_reference (reference data).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context on when to use the tool ('beyond the operator-reported registry status') and gives concrete usage for pagination ('when a page reports truncated, repeat the call with the reported nextOffset'). It does not explicitly name alternative tools or specify when not to use it, but the purpose framing effectively guides selection. The pagination guidance is a strong practical instruction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
openchargemap_lookup_referenceopenchargemap-mcp-server: lookup referenceARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum entries to return when browsing or when a query matches several. Max 100. | |
| query | No | 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 | No | 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 | Yes | 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. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cap | No | The limit that was applied. |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Entries in the returned page. |
| notice | No | How to reach the entries this page left out. |
| source | No | 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. |
| matches | No | Matching reference entries, best/exact match first. |
| category | No | The reference category queried. |
| truncated | No | True when matching entries were left out of the returned page. |
| nextOffset | No | The offset to pass on an otherwise identical call to read the next page. Absent on the last page. |
| totalCount | No | Entries matching before the offset/limit page was taken — the whole category when browsing, every match when a query was given. |
| attribution | No | Required CC BY 4.0 attribution to Open Charge Map contributors. |
| filterParam | No | The find_stations input parameter these IDs feed (e.g. "connectiontypeid"). Omitted for categories with no direct filter (currenttypes; countries use countrycode). |
| snapshotDate | No | 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. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and idempotentHint=true, so the safety profile is covered. The description adds substantial behavioral detail beyond that: it explains the query matching is case-insensitive and matches aliases, describes pagination behavior ('Large categories come back one page at a time'), and instructs the agent to follow nextOffset for subsequent pages. It also clarifies that offset skips entries and the order is stable. These are valuable runtime behaviors not inferable from annotations alone.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, dense paragraph with no filler. Every sentence serves a purpose: purpose statement, category-to-ID mapping examples, browsing instruction, and pagination handling. The most important information (what it resolves and for whom) is front-loaded. It is appropriately concise for the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has an output schema (so return format is externally defined), annotations cover safety and idempotency, and the description explains all operational nuances: category semantics, query behavior, pagination, and offset usage. There is nothing missing that an agent would need to correctly invoke this tool, even for large reference sets. The combination of schema, annotations, and description is complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already provides 100% coverage with descriptive parameter descriptions (e.g., category enum values mapped to ID types, query pattern and alias matching). The description enhances this by giving concrete examples ('CCS' -> connectiontypeid, 'ChargePoint' -> operatorid) and explaining the relationship between offset and nextOffset for paging. This goes beyond the schema's baseline, but since the schema is already thorough, the added value is an incremental improvement rather than a necessity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'Resolve Open Charge Map reference data to the integer IDs that openchargemap_find_stations filters require.' It names the consumer tool and explicitly differentiates itself from siblings (find_stations is the target, get_station and get_station_comments are unrelated). The mapping examples further clarify the exact role.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear, actionable usage context: pick a category, pass a name/code to get an ID, or omit the query to browse. It also explains pagination for large categories. However, it does not explicitly state when not to use this tool versus alternatives (e.g., 'use this only for reference lookups, not station details'), though the purpose statement makes that inference straightforward. Is it explicit enough for a 5? It names the dependent tool, so it effectively guides selection, but the lack of an explicit exclusion directive keeps it at 4.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
4 tool updates
- Changed
openchargemap_find_stations6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "stations", + "searchSummary", + "attribution", + "totalCount" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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" +} - removed
Output schema / requiredRemoved value: -[ - "stations", - "searchSummary", - "attribution", - "totalCount" -]
- Changed
openchargemap_get_station6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "station", + "attribution" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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" +} - removed
Output schema / requiredRemoved value: -[ - "station", - "attribution" -]
- Changed
openchargemap_get_station_comments6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "stationId", + "stationTitle", + "comments", + "totalComments", + "attribution", + "totalCount" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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" +} - removed
Output schema / requiredRemoved value: -[ - "stationId", - "stationTitle", - "comments", - "totalComments", - "attribution", - "totalCount" -]
- Changed
openchargemap_lookup_reference6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "category", + "matches", + "snapshotDate", + "source", + "attribution", + "totalCount" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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" +} - removed
Output schema / requiredRemoved value: -[ - "category", - "matches", - "snapshotDate", - "source", - "attribution", - "totalCount" -]
4 tool updates
- Changed
openchargemap_find_stations7 fields changed- changed
Input schema / properties / boundingbox / descriptionPrevious value: -"Bounding-box search as an alternative to a center+radius. Mutually exclusive with latitude/longitude/distance."New value: +"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." - added
Input schema / properties / offsetAdded value: +{ + "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" +} - added
Output schema / properties / nextOffsetAdded value: +{ + "description": "The offset to pass on an otherwise identical call to read the next page. Absent when nothing further was retrieved.", + "type": "number" +} - added
Output schema / properties / noticeAdded value: +{ + "description": "How to reach the stations this page left out, or why it came back empty.", + "type": "string" +} - changed
Output schema / properties / shown / descriptionPrevious value: -"Number of stations returned when the cap was hit."New value: +"Stations in the returned page." - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Number of stations returned."New value: +"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." - changed
Output schema / properties / truncated / descriptionPrevious value: -"True when results were capped at maxresults."New value: +"True when matching stations were left out of the returned page."
- Changed
openchargemap_get_station1 field changed- changed
Input schema / properties / includeComments / descriptionPrevious value: -"Include community check-ins and comments inline in the response. Adds payload but gives the real-world reliability signal alongside the registry status. For comments alone, use openchargemap_get_station_comments."New value: +"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."
- Changed
openchargemap_get_station_comments9 fields changed- added
Input schema / properties / offsetAdded value: +{ + "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" +} - changed
Output schema / properties / comments / descriptionPrevious value: -"Community comments, newest first. Empty array means OCM has no check-ins for this station — absence of reports is not evidence the charger works."New value: +"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." - added
Output schema / properties / nextOffsetAdded value: +{ + "description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page.", + "type": "number" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when the station has no check-ins on record."New value: +"How to reach the comments this page left out, or why the station has none on record." - changed
Output schema / properties / shown / descriptionPrevious value: -"Number of comments returned when the cap was hit."New value: +"Comments in the returned page." - added
Output schema / properties / totalCommentsAdded value: +{ + "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" +} - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Number of comments returned."New value: +"Comments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size." - changed
Output schema / properties / truncated / descriptionPrevious value: -"True when comments were capped at maxresults."New value: +"True when comments were left out of the returned page." - changed
Output schema / requiredPrevious value: -[ - "stationId", - "stationTitle", - "comments", - "attribution", - "totalCount" -]New value: +[ + "stationId", + "stationTitle", + "comments", + "totalComments", + "attribution", + "totalCount" +]
- Changed
openchargemap_lookup_reference9 fields changed- added
Input schema / properties / offsetAdded value: +{ + "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" +} - added
Output schema / properties / nextOffsetAdded value: +{ + "description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page.", + "type": "number" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"How to reach the entries beyond the cap when a browse was capped."New value: +"How to reach the entries this page left out." - changed
Output schema / properties / shown / descriptionPrevious value: -"Number of entries returned when the cap was hit."New value: +"Entries in the returned page." - changed
Output schema / properties / snapshotDate / descriptionPrevious value: -"Date the bundled reference snapshot was captured, so callers know the data vintage."New value: +"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." - added
Output schema / properties / sourceAdded value: +{ + "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" +} - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Number of entries returned."New value: +"Entries matching before the offset/limit page was taken — the whole category when browsing, every match when a query was given." - changed
Output schema / properties / truncated / descriptionPrevious value: -"True when a browse was capped at limit."New value: +"True when matching entries were left out of the returned page." - changed
Output schema / requiredPrevious value: -[ - "category", - "matches", - "snapshotDate", - "attribution", - "totalCount" -]New value: +[ + "category", + "matches", + "snapshotDate", + "source", + "attribution", + "totalCount" +]
4 tool updates
- Changed
openchargemap_find_stations6 fields changed- changed
Input schema / properties / connectiontypeid / anyOfPrevious value: -[ - { - "description": "A single reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "description": "Several reference IDs, OR-matched.", - "items": { - "description": "A reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "maxItems": 10, - "type": "array" - } -]New value: +[ + { + "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" + } +] - changed
Input schema / properties / levelid / anyOfPrevious value: -[ - { - "description": "A single reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "description": "Several reference IDs, OR-matched.", - "items": { - "description": "A reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "maxItems": 3, - "type": "array" - } -]New value: +[ + { + "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" + } +] - changed
Input schema / properties / operatorid / anyOfPrevious value: -[ - { - "description": "A single reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "description": "Several reference IDs, OR-matched.", - "items": { - "description": "A reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "maxItems": 10, - "type": "array" - } -]New value: +[ + { + "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" + } +] - changed
Input schema / properties / statustypeid / anyOfPrevious value: -[ - { - "description": "A single reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "description": "Several reference IDs, OR-matched.", - "items": { - "description": "A reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "maxItems": 10, - "type": "array" - } -]New value: +[ + { + "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" + } +] - changed
Input schema / properties / usagetypeid / anyOfPrevious value: -[ - { - "description": "A single reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "description": "Several reference IDs, OR-matched.", - "items": { - "description": "A reference ID.", - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - "maxItems": 10, - "type": "array" - } -]New value: +[ + { + "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" + } +] - added
Output schema / properties / stations / items / properties / statusTypeIdAdded value: +{ + "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.", + "type": "number" +}
- Changed
openchargemap_get_station5 fields changed- added
Output schema / properties / station / properties / comments / items / properties / checkinStatusAdded value: +{ + "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" +} - added
Output schema / properties / station / properties / comments / items / properties / checkinStatusIdAdded value: +{ + "description": "Numeric ID of the check-in outcome, stable across renames of its title.", + "type": "number" +} - added
Output schema / properties / station / properties / comments / items / properties / checkinStatusIsPositiveAdded value: +{ + "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" +} - added
Output schema / properties / station / properties / comments / items / properties / relatedUrlAdded value: +{ + "description": "Link the commenter attached. Absent when none was given.", + "type": "string" +} - added
Output schema / properties / station / properties / statusTypeIdAdded value: +{ + "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.", + "type": "number" +}
- Changed
openchargemap_get_station_comments5 fields changed- added
Output schema / properties / comments / items / properties / checkinStatusAdded value: +{ + "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" +} - added
Output schema / properties / comments / items / properties / checkinStatusIdAdded value: +{ + "description": "Numeric ID of the check-in outcome, stable across renames of its title.", + "type": "number" +} - added
Output schema / properties / comments / items / properties / checkinStatusIsPositiveAdded value: +{ + "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" +} - added
Output schema / properties / comments / items / properties / relatedUrlAdded value: +{ + "description": "Link the commenter attached. Absent when none was given.", + "type": "string" +} - added
Output schema / properties / registryStatusIdAdded value: +{ + "description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.", + "type": "number" +}
- Changed
openchargemap_lookup_reference3 fields changed- removed
Input schema / properties / query / minLengthRemoved value: -1 - added
Input schema / properties / query / patternAdded value: +"\\S" - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when a query matched nothing."New value: +"How to reach the entries beyond the cap when a browse was capped."
4 tool updates
- Changed
openchargemap_find_stations5 fields changed- changed
Input schema / properties / maxresults / descriptionPrevious value: -"Maximum stations to return, ordered by distance from the search point. Max 200. Larger values cost more payload and upstream load — prefer tightening filters over raising this."New value: +"Maximum stations to return, ordered by distance from the search point. Max 200." - changed
Output schema / properties / stations / items / properties / distanceUnit / descriptionPrevious value: -"Unit of the distance value (normalized from the OCM integer enum: 1=KM, 2=Miles)."New value: +"Unit of the distance value." - changed
Output schema / properties / stations / items / properties / id / descriptionPrevious value: -"OCM station ID. Pass to openchargemap_get_station or openchargemap_get_station_comments."New value: +"OCM station ID." - changed
Output schema / properties / stations / items / properties / isOperational / descriptionPrevious value: -"Whether the registry marks the status operational. Absent (not null) when StatusType is \"Unknown\" (ID=0) — OCM omits the flag then. A true value can still mask a broken charger — corroborate with comments and dateLastVerified."New value: +"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." - changed
Output schema / properties / stations / items / properties / isRecentlyVerified / descriptionPrevious value: -"OCM flag: whether the listing was verified recently."New value: +"Whether the listing was verified recently."
- Changed
openchargemap_get_station6 fields changed- changed
Input schema / properties / id / descriptionPrevious value: -"Numeric OCM station ID (e.g. 145452). Obtain one from openchargemap_find_stations. Note: UUID lookup is not supported by the OCM API."New value: +"Numeric OCM station ID (e.g. 145452)." - changed
Output schema / properties / reliabilityNote / descriptionPrevious value: -"Server-computed caveat when registry status and recency suggest the listing may not reflect reality (plain prose from observable facts; no synthetic score). Omitted when status is fresh and uncontested."New value: +"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." - changed
Output schema / properties / station / properties / distanceUnit / descriptionPrevious value: -"Unit of the distance value (normalized from the OCM integer enum: 1=KM, 2=Miles)."New value: +"Unit of the distance value." - changed
Output schema / properties / station / properties / id / descriptionPrevious value: -"OCM station ID. Pass to openchargemap_get_station or openchargemap_get_station_comments."New value: +"OCM station ID." - changed
Output schema / properties / station / properties / isOperational / descriptionPrevious value: -"Whether the registry marks the status operational. Absent (not null) when StatusType is \"Unknown\" (ID=0) — OCM omits the flag then. A true value can still mask a broken charger — corroborate with comments and dateLastVerified."New value: +"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." - changed
Output schema / properties / station / properties / isRecentlyVerified / descriptionPrevious value: -"OCM flag: whether the listing was verified recently."New value: +"Whether the listing was verified recently."
- Changed
openchargemap_get_station_comments4 fields changed- changed
Input schema / properties / id / descriptionPrevious value: -"Numeric OCM station ID. Get one from openchargemap_find_stations. Note: UUID lookup is not supported by the OCM API."New value: +"Numeric OCM station ID." - changed
Input schema / properties / maxresults / descriptionPrevious value: -"Maximum comments to return (handler trims, newest first). The OCM API returns all embedded comments — this caps what the tool surfaces. Max 100."New value: +"Maximum comments to return, newest first. Max 100." - changed
Output schema / properties / isOperational / descriptionPrevious value: -"Whether the registry marks the station operational. Absent (not null) when status is Unknown — OCM omits the flag then. Compare against the comments below — they are the real-world check."New value: +"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." - changed
Output schema / properties / reliabilityNote / descriptionPrevious value: -"Server-computed caveat when status and comments disagree or the listing is stale (plain prose from observable facts; no synthetic score). Omitted when nothing to flag."New value: +"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."
- Changed
openchargemap_lookup_reference2 fields changed- changed
Output schema / properties / matches / descriptionPrevious value: -"Matching reference entries, best/exact match first. Use the id in a find_stations filter."New value: +"Matching reference entries, best/exact match first." - changed
Output schema / properties / matches / items / properties / id / descriptionPrevious value: -"The reference ID — pass to the matching openchargemap_find_stations filter (e.g. connectiontypeid)."New value: +"The reference ID for this entry."
4 tool updates
- First observed
openchargemap_find_stations - First observed
openchargemap_get_station - First observed
openchargemap_get_station_comments - First observed
openchargemap_lookup_reference
Frequently Asked Questions
Claiming proves that you control a remote MCP connector. It does not move, proxy, or interrupt the server.
Open the connector listing, choose Claim ownership, and sign in to Glama.
Complete one verification method:
GitHub identity — fastest for official registry listings. For a namespace such as
io.github.alice/server, link the matching GitHub user, then choose Claim with GitHub. An organization namespace such asio.github.acme/serveralso needs that organization to have installed the Glama AI GitHub App and approved its permissions, because GitHub discloses organization membership only to apps it has installed. Use HTTP or DNS when it has not.HTTP challenge — works when you can deploy a public file. Generate a token, publish the exact JSON Glama shows at
/.well-known/glama.jsonon the same origin as the connector, then choose Check HTTP challenge.DNS challenge — works when you control DNS but cannot change the server. Generate a token, create the exact TXT record Glama shows, wait for it to propagate, then choose Check DNS challenge.
After verification, Glama sends a confirmation email and gives you access to listing details, thumbnails, health checks, and analytics. Keep the HTTP file or DNS record in place: Glama periodically checks it and ownership remains verified while the token is discoverable.
The HTTP ownership file has this structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"claim": "glama_claim_..."
}Claim tokens are opaque, stable, and bound to the signed-in Glama account. They contain no email address or other personal information. If Glama can no longer discover a verified HTTP or DNS token, it starts a seven-day grace period before removing claim-based access. Restore the same token during that period to keep ownership verified. Never publish an email address, Glama session token, GitHub token, or connector credential as ownership proof.
If verification fails, confirm that you copied the current token exactly. The HTTP file must be public, return valid JSON with a successful HTTP response, and stay on the connector's origin. DNS changes may need more time to propagate. A claim cannot transfer to a different origin or hostname: if the connector target changes, Glama starts the grace period and the new target must be claimed separately after the previous claim is released.
For a connector linked to the official MCP Registry, registry updates continue to replace its name, description, and URL by default. After claiming, open Manage connector and enable Use Glama listing details as the source of truth if edits made on Glama should be preserved. Categories and thumbnails are always managed on Glama; registry linkage and technical connection settings continue to sync.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
To improve your MCP server's ranking:
Claim ownership of the server listing
Complete the server profile with an accurate description and thumbnail
Provide a test profile so Glama can connect to and evaluate the server
Keep tool definitions clear and complete to earn a high Tool Definition Quality Score (TDQS)
Route real usage through the Glama Gateway; more recorded successful server uses also improve the ranking
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Connectors
Open Charge Map MCP — global EV charging station database (openchargemap.io).
Find EV charging stations, live availability and prices across the Netherlands via NDW data.
Operate a network of EV charge points over OCPP: status, sessions, tariffs, prices, remote commands
1Find air-quality stations and read pollutant observations from government monitors via OpenAQ v3.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables querying global EV charging station data from Open Charge Map through natural language, accessing real-time station information via the Pipeworx gateway.19MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with the Open Charge Map API, allowing exploration of endpoints, test requests, and using documentation to integrate the SDK.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceRecommends EV charging stations with low failure risk by considering vehicle type, connector, remaining range, and real-time public data.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with EV charging infrastructure through OCHP (Open Clearing House Protocol) services.Apache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.
TDQS
Each tool has a distinct role: discovery (find_stations), retrieval (get_station), community feedback (get_station_comments), and reference lookup (lookup_reference). No two tools overlap in purpose, and the descriptions reinforce their boundaries.
All tool names share the 'openchargemap_' prefix followed by a clear verb_noun pattern (find_stations, get_station, get_station_comments, lookup_reference). The naming is uniform and predictive, making it easy for an agent to infer function.
With 4 tools, the server is focused and well-scoped for a read-only EV charging station registry. Each tool serves an essential query need (search, detail, comments, reference data) without unnecessary clutter.
The tool set covers the full lifecycle of querying station data: resolving reference IDs via lookup_reference, searching with filters, retrieving detailed records, and accessing community feedback. This is complete for the stated purpose, with no obvious dead ends.