Skip to main content
Glama

openchargemap-mcp-server: get station comments

openchargemap_get_station_comments
Read-onlyIdempotent

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesNumeric OCM station ID.
offsetNoComments 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.
maxresultsNoMaximum comments to return, newest first. Max 100.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
capNoThe maxresults cap that was applied.
errorNoPresent when the call failed. Absent on success.
shownNoComments in the returned page.
noticeNoHow to reach the comments this page left out, or why the station has none on record.
commentsNoThe 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.
stationIdNoOCM station ID the comments belong to.
truncatedNoTrue when comments were left out of the returned page.
nextOffsetNoThe offset to pass on an otherwise identical call to read the next page. Absent on the last page.
totalCountNoComments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size.
attributionNoRequired CC BY 4.0 attribution to Open Charge Map contributors.
stationTitleNoStation name, for context.
isOperationalNoWhether the registry marks the station operational. Absent when the operational state is unknown. Compare against the comments below — they are the real-world check.
totalCommentsNoComments 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.
registryStatusNoCurrent registry operational status (operator-reported).
reliabilityNoteNoA caveat when the registry status, verification age, coordinates, or comments suggest the listing may not reflect reality. Omitted when there is nothing to flag.
dateLastVerifiedNoISO 8601 date the listing was last verified. null when never verified.
registryStatusIdNoRegistry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record.

TDQS

A4.3/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness5/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.5/5.0
Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness5/5

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.