openchargemap-mcp-server
An MCP server that allows agents to search for EV charging stations globally by location or bounding box, retrieve full station details including operator and access rules, resolve reference IDs for connectors and networks, and view community reliability check-ins to verify charger status.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://openchargemap.caseyjhand.com/mcpWhat its tools do
4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Find EV charging stations near a specific geographic point or within a defined bounding box
- Retrieve full station details including connections, power, and access rules by ID
- Resolve connector or network names to integer filter IDs for precise searching
- View community check-ins to assess the real-world reliability of a charging station
Source and maintenance
Community listingRegistry 0.2.0
- Maintenance checked
Protocol and capabilities
- Server
- openchargemap-mcp-server 0.2.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 4 advertised
- Resources
- 1 advertised
- Resource templates
- 2 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
4 advertised
openchargemap_find_stations — openchargemap-mcp-server: find stations
Advertised read-onlyOpen-world
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_search_places 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 IDs with openchargemap_lookup_reference and pass every returned ID (e.g. "CCS" -> [32, 33]; Open Charge Map distinguishes CCS Type 1 (32, common in North America) and Type 2 (33, common in Europe); 33 alone can miss Type 1 stations). 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.
openchargemap_find_stations input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"type": "integer",
"default": 0,
"maximum": 499,
"minimum": 0,
"description": "Matching stations to skip before the returned page, for reading past a truncated result. Repeat the same search with the nextOffset value the previous call reported. One search reaches at most 500 stations, so 499 is the deepest offset that can return one — narrow the area or add filters to reach stations beyond that. Ordering is by distance and stable, but Open Charge Map is edited continuously, so a station added or removed between pages can shift what a later offset lands on."
},
"levelid": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "A single reference ID."
},
{
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "A reference ID."
},
"maxItems": 3,
"minItems": 1,
"description": "Several reference IDs, OR-matched. At least one."
}
],
"description": "Charge level ID (1=Low <2kW, 2=Medium >2kW, 3=High >40kW/fast). Array OR-matched. Use 3 as a coarse \"fast charging only\" filter when a specific connector is not required."
},
"distance": {
"type": "number",
"default": 25,
"maximum": 500,
"description": "Search radius from the center point, in the unit given by distanceUnit (default km). Max 500. Keep small (5-25) for dense urban areas; widen for rural coverage.",
"exclusiveMinimum": 0
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Center latitude (WGS84 decimal degrees). Use with longitude + distance for a radius search. Resolve place names via openstreetmap_search_places first."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Center longitude (WGS84 decimal degrees). Use with latitude + distance for a radius search."
},
"maxresults": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum stations to return, ordered by distance from the search point. Max 200; larger positive integers are clamped unless OPENCHARGEMAP_CLAMP_LIMITS=false."
},
"minpowerkw": {
"type": "number",
"maximum": 1000,
"description": "Minimum charging power in kW across any connection at the station. Use ~50 for DC fast charging, ~150 for high-power DC. Stations whose fastest connection is below this are excluded.",
"exclusiveMinimum": 0
},
"operatorid": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "A single reference ID."
},
{
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "A reference ID."
},
"maxItems": 10,
"minItems": 1,
"description": "Several reference IDs, OR-matched. At least one."
}
],
"description": "Operator/network ID, or array of IDs (OR-matched). Resolve a network name with openchargemap_lookup_reference (category \"operators\") — e.g. \"Tesla\", \"ChargePoint\"."
},
"boundingbox": {
"type": "object",
"required": [
"sw_lat",
"sw_lng",
"ne_lat",
"ne_lng"
],
"properties": {
"ne_lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "North-east corner latitude."
},
"ne_lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "North-east corner longitude."
},
"sw_lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "South-west corner latitude."
},
"sw_lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "South-west corner longitude."
}
},
"description": "Bounding-box search as an alternative to a center+radius. Mutually exclusive with latitude/longitude/distance — sending a boundingbox alongside a latitude or a longitude is rejected, not resolved in favour of one of them."
},
"countrycode": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "Restrict to one country by ISO 3166-1 alpha-2 code (e.g. \"US\", \"FR\", \"GB\"). Omit for a global search. An unrecognized code is not applied; the summary and notice disclose the unrestricted search. Resolve valid codes with openchargemap_lookup_reference (countries)."
},
"usagetypeid": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A single reference ID."
},
{
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A reference ID."
},
"maxItems": 10,
"minItems": 1,
"description": "Several reference IDs, OR-matched. At least one."
}
],
"description": "Usage/access type ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category \"usagetypes\") — e.g. Public=1, Public-Pay At Location=5, Public-Membership Required=4."
},
"distanceUnit": {
"enum": [
"KM",
"Miles"
],
"type": "string",
"default": "KM",
"description": "Unit for the distance parameter and the returned distance values."
},
"statustypeid": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A single reference ID."
},
{
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A reference ID."
},
"maxItems": 10,
"minItems": 1,
"description": "Several reference IDs, OR-matched. At least one."
}
],
"description": "Registry operational-status ID, or array (OR-matched). Resolve via openchargemap_lookup_reference (category \"statustypes\"). NOTE: registry status is operator-reported and can be stale — combine with dateLastVerified and openchargemap_get_station_comments to judge real-world reliability, do not treat it as ground truth."
},
"minchargepoints": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Minimum number of charge points (stalls) at the station. Filters out single-point locations when you need a station likely to have an open stall.",
"exclusiveMinimum": 0
},
"connectiontypeid": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A single reference ID."
},
{
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "A reference ID."
},
"maxItems": 10,
"minItems": 1,
"description": "Several reference IDs, OR-matched. At least one."
}
],
"description": "Connector type ID, or an array of IDs (OR-matched). Resolve names with openchargemap_lookup_reference — e.g. CCS is two IDs, 32 (Type 1, North America) and 33 (Type 2, Europe and most other regions), so pass [32, 33] when the region is unknown; CHAdeMO=2, NACS/Tesla Supercharger=27, Type 2 socket=25, Type 1/J1772=1."
}
},
"additionalProperties": false
}openchargemap_find_stations output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"stations",
"searchSummary",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The maxresults cap that was applied."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_location",
"upstream_unavailable",
"auth_failed"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_location`: No search area was provided; or only one half of a center arrived; or a boundingbox arrived alongside a latitude or a longitude. `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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Stations in the returned page."
},
"notice": {
"type": "string",
"description": "How to reach the stations this page left out, or why it came back empty."
},
"stations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"uuid",
"title",
"address",
"connections"
],
"properties": {
"id": {
"type": "number",
"description": "OCM station ID."
},
"uuid": {
"type": "string",
"description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input)."
},
"title": {
"type": "string",
"description": "Station name / location title."
},
"status": {
"type": "string",
"description": "Registry operational status (e.g. \"Operational\", \"Temporarily Unavailable\"). Operator-reported; may be stale."
},
"address": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"town": {
"type": "string",
"description": "Town or city."
},
"line1": {
"type": "string",
"description": "Street address line."
},
"country": {
"type": "string",
"description": "Country name."
},
"latitude": {
"type": "number",
"description": "Station latitude (WGS84)."
},
"postcode": {
"type": "string",
"description": "Postal/ZIP code."
},
"longitude": {
"type": "number",
"description": "Station longitude (WGS84)."
},
"countryCode": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code."
},
"accessComments": {
"type": "string",
"description": "Free-text access notes (e.g. \"24 hours daily\")."
},
"stateOrProvince": {
"type": "string",
"description": "State or province."
}
},
"description": "Structured station address and coordinates.",
"additionalProperties": false
},
"distance": {
"type": "number",
"description": "Distance from the search point. Absent for bounding-box searches."
},
"operator": {
"type": "string",
"description": "Operating network name (e.g. \"ChargePoint\", \"Tesla\"). Absent when OCM has no operator on record."
},
"usageType": {
"type": "string",
"description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type."
},
"operatorId": {
"type": "number",
"description": "OCM operator ID — resolve names via openchargemap_lookup_reference."
},
"connections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amps": {
"type": [
"number",
"null"
],
"description": "Rated amperage. Often null."
},
"level": {
"type": "string",
"description": "Charge level title (e.g. \"Level 2 : Medium (Over 2kW)\")."
},
"notes": {
"type": "string",
"description": "Provider notes about this connector."
},
"status": {
"type": "string",
"description": "Registry status title for this connector."
},
"levelId": {
"type": "number",
"description": "Charge level ID (1/2/3)."
},
"powerKW": {
"type": [
"number",
"null"
],
"description": "Rated power in kW for this connection. null/absent when unknown."
},
"voltage": {
"type": [
"number",
"null"
],
"description": "Rated voltage. Often null."
},
"quantity": {
"type": [
"number",
"null"
],
"description": "Number of connectors of this type. null when unknown."
},
"currentType": {
"type": "string",
"description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\")."
},
"statusTypeId": {
"type": "number",
"description": "Registry status ID for this connector; absent when no status ID is on record."
},
"isOperational": {
"type": "boolean",
"description": "Faithful registry operational flag for this connector; absent when unknown."
},
"connectionType": {
"type": "string",
"description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\")."
},
"connectionTypeId": {
"type": "number",
"description": "Connector type ID — resolve via openchargemap_lookup_reference."
}
},
"description": "A connector at the station.",
"additionalProperties": false
},
"description": "Connectors at the station. Empty when OCM has no connection data on record."
},
"dataProvider": {
"type": "string",
"description": "Source that provided the listing (e.g. \"afdc.energy.gov\")."
},
"distanceUnit": {
"enum": [
"KM",
"Miles"
],
"type": "string",
"description": "Unit of the distance value."
},
"statusTypeId": {
"type": "number",
"description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record."
},
"isOperational": {
"type": "boolean",
"description": "Whether the registry marks the status operational. Absent when the operational state is unknown. A true value can still mask a broken charger — corroborate with comments and dateLastVerified."
},
"numberOfPoints": {
"type": "number",
"description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero."
},
"isPayAtLocation": {
"type": "boolean",
"description": "Whether payment is required at the location. Absent when usage type is unknown."
},
"dateLastVerified": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified."
},
"isOpenDataLicensed": {
"type": "boolean",
"description": "Whether the provider marks its data as openly licensed. Absent when unknown."
},
"isRecentlyVerified": {
"type": "boolean",
"description": "Whether the listing was verified recently."
},
"dataProviderLicense": {
"type": "string",
"description": "License terms supplied by the station data provider. Absent when unspecified."
},
"isAccessKeyRequired": {
"type": "boolean",
"description": "Whether a physical access key is required. Absent when usage type is unknown."
},
"isMembershipRequired": {
"type": "boolean",
"description": "Whether a membership or RFID card is required. Absent when usage type is unknown."
}
},
"description": "A charging station record.",
"additionalProperties": false
},
"description": "Matching stations, ordered by distance from the search point."
},
"truncated": {
"type": "boolean",
"description": "True when matching stations were left out of the returned page."
},
"nextOffset": {
"type": "number",
"description": "The offset to pass on an otherwise identical call to read the next page. Absent when nothing further was retrieved."
},
"totalCount": {
"type": "number",
"description": "Matching stations in the retrieved pool of up to 500 candidates, before offset/maxresults selects the page. Exact when no additional upstream stations remain; otherwise a floor. Stable across pages while the pool remains cached. The notice states whether additional upstream stations exist."
},
"attribution": {
"type": "string",
"description": "Attribution to Open Charge Map contributors and station data providers; license terms vary by provider."
},
"searchSummary": {
"type": "string",
"description": "Human-readable echo of the resolved search: location mode, scope, and active filters as the server applied them."
}
},
"additionalProperties": false
}openchargemap_find_stations annotations
{
"readOnlyHint": true,
"openWorldHint": true
}openchargemap_get_station — openchargemap-mcp-server: get station
Advertised read-onlyOpen-world
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.
openchargemap_get_station input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric OCM station ID (e.g. 145452).",
"exclusiveMinimum": 0
},
"includeComments": {
"type": "boolean",
"default": false,
"description": "Include community check-ins and comments inline in the response. Adds payload but gives the real-world reliability signal alongside the registry status. Every comment on record comes back at once, unpaged — on a station with hundreds of check-ins that is a large response, so prefer openchargemap_get_station_comments, which returns them a page at a time."
}
},
"additionalProperties": false
}openchargemap_get_station output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"station",
"attribution"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found",
"upstream_unavailable",
"auth_failed"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: OCM returned an empty result for the given numeric ID (HTTP 200 with []) — 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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"station": {
"type": "object",
"required": [
"id",
"uuid",
"title",
"address",
"connections"
],
"properties": {
"id": {
"type": "number",
"description": "OCM station ID."
},
"uuid": {
"type": "string",
"description": "OCM station UUID — stable cross-system identifier (cannot be used as a lookup input)."
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Image URL."
},
"comment": {
"type": "string",
"description": "Caption / comment."
}
},
"description": "A user-submitted photo.",
"additionalProperties": false
},
"description": "User-submitted photos of the station. Absent when none."
},
"title": {
"type": "string",
"description": "Station name / location title."
},
"status": {
"type": "string",
"description": "Registry operational status (e.g. \"Operational\", \"Temporarily Unavailable\"). Operator-reported; may be stale."
},
"address": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"town": {
"type": "string",
"description": "Town or city."
},
"line1": {
"type": "string",
"description": "Street address line."
},
"country": {
"type": "string",
"description": "Country name."
},
"latitude": {
"type": "number",
"description": "Station latitude (WGS84)."
},
"postcode": {
"type": "string",
"description": "Postal/ZIP code."
},
"longitude": {
"type": "number",
"description": "Station longitude (WGS84)."
},
"countryCode": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code."
},
"accessComments": {
"type": "string",
"description": "Free-text access notes (e.g. \"24 hours daily\")."
},
"stateOrProvince": {
"type": "string",
"description": "State or province."
}
},
"description": "Structured station address and coordinates.",
"additionalProperties": false
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "string",
"description": "Commenter username. Absent for anonymous."
},
"rating": {
"type": [
"number",
"null"
],
"description": "User rating 1–5. null when not given."
},
"comment": {
"type": "string",
"description": "Comment text."
},
"relatedUrl": {
"type": "string",
"description": "Link the commenter attached. Absent when none was given."
},
"commentType": {
"type": "string",
"description": "Comment type (e.g. \"General Comment\", \"Fault Report\")."
},
"dateCreated": {
"type": "string",
"description": "ISO 8601 timestamp the comment was posted."
},
"checkinStatus": {
"type": "string",
"description": "The visit outcome the driver recorded (e.g. \"Charged Successfully\", \"Failed to Charge (Equipment Not Operational)\"). Carries the result on check-ins that have no comment text. Absent when the visitor recorded no outcome."
},
"checkinStatusId": {
"type": "number",
"description": "Numeric ID of the check-in outcome, stable across renames of its title."
},
"checkinStatusIsPositive": {
"type": "boolean",
"description": "Whether the registry classes this outcome as a good visit. Absent when the outcome carries no verdict either way (e.g. \"Did Not Visit Location\") or when none was recorded."
}
},
"description": "A community check-in or comment.",
"additionalProperties": false
},
"description": "Community check-ins, present only when includeComments=true. Empty array means none on record."
},
"distance": {
"type": "number",
"description": "Distance from the search point. Absent for bounding-box searches."
},
"operator": {
"type": "string",
"description": "Operating network name (e.g. \"ChargePoint\", \"Tesla\"). Absent when OCM has no operator on record."
},
"usageCost": {
"type": "string",
"description": "Free-text cost description (e.g. \"£0.30/kWh\"). Often absent — absence means unknown, not free."
},
"usageType": {
"type": "string",
"description": "Access/usage type title (e.g. \"Public\", \"Public - Pay At Location\"). Absent when OCM has no usage type."
},
"operatorId": {
"type": "number",
"description": "OCM operator ID — resolve names via openchargemap_lookup_reference."
},
"connections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amps": {
"type": [
"number",
"null"
],
"description": "Rated amperage. Often null."
},
"level": {
"type": "string",
"description": "Charge level title (e.g. \"Level 2 : Medium (Over 2kW)\")."
},
"notes": {
"type": "string",
"description": "Provider notes about this connector."
},
"status": {
"type": "string",
"description": "Registry status title for this connector."
},
"levelId": {
"type": "number",
"description": "Charge level ID (1/2/3)."
},
"powerKW": {
"type": [
"number",
"null"
],
"description": "Rated power in kW for this connection. null/absent when unknown."
},
"voltage": {
"type": [
"number",
"null"
],
"description": "Rated voltage. Often null."
},
"quantity": {
"type": [
"number",
"null"
],
"description": "Number of connectors of this type. null when unknown."
},
"currentType": {
"type": "string",
"description": "Current type (e.g. \"AC (Single-Phase)\", \"DC\")."
},
"statusTypeId": {
"type": "number",
"description": "Registry status ID for this connector; absent when no status ID is on record."
},
"isOperational": {
"type": "boolean",
"description": "Faithful registry operational flag for this connector; absent when unknown."
},
"connectionType": {
"type": "string",
"description": "Connector type title (e.g. \"CCS (Type 2)\", \"CHAdeMO\")."
},
"connectionTypeId": {
"type": "number",
"description": "Connector type ID — resolve via openchargemap_lookup_reference."
}
},
"description": "A connector at the station.",
"additionalProperties": false
},
"description": "Connectors at the station. Empty when OCM has no connection data on record."
},
"dataProvider": {
"type": "string",
"description": "Source that provided the listing (e.g. \"afdc.energy.gov\")."
},
"distanceUnit": {
"enum": [
"KM",
"Miles"
],
"type": "string",
"description": "Unit of the distance value."
},
"statusTypeId": {
"type": "number",
"description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record."
},
"isOperational": {
"type": "boolean",
"description": "Whether the registry marks the status operational. Absent when the operational state is unknown. A true value can still mask a broken charger — corroborate with comments and dateLastVerified."
},
"numberOfPoints": {
"type": "number",
"description": "Reported number of charge points (stalls). Often absent — absence means unknown, not zero."
},
"dataProviderUrl": {
"type": "string",
"description": "Source provider website."
},
"generalComments": {
"type": "string",
"description": "Operator/free-text notes about the station. Absent when none on record."
},
"isPayAtLocation": {
"type": "boolean",
"description": "Whether payment is required at the location. Absent when usage type is unknown."
},
"dateLastVerified": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was last verified. Stale (>12 months) is a reliability caveat. null when never verified."
},
"submissionStatus": {
"type": "string",
"description": "OCM submission/publication status (e.g. \"Imported and Published\")."
},
"isOpenDataLicensed": {
"type": "boolean",
"description": "Whether the provider marks its data as openly licensed. Absent when unknown."
},
"isRecentlyVerified": {
"type": "boolean",
"description": "Whether the listing was verified recently."
},
"dataProviderLicense": {
"type": "string",
"description": "License terms supplied by the station data provider. Absent when unspecified."
},
"isAccessKeyRequired": {
"type": "boolean",
"description": "Whether a physical access key is required. Absent when usage type is unknown."
},
"dateLastStatusUpdate": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp of the last status update."
},
"isMembershipRequired": {
"type": "boolean",
"description": "Whether a membership or RFID card is required. Absent when usage type is unknown."
}
},
"description": "The full station record.",
"additionalProperties": false
},
"attribution": {
"type": "string",
"description": "Attribution to Open Charge Map contributors and station data providers; license terms vary by provider."
},
"reliabilityNote": {
"type": "string",
"description": "A caveat when the registry status, verification age, coordinates, or comments suggest the listing may not reflect reality. Omitted when there is nothing to flag."
}
},
"additionalProperties": false
}openchargemap_get_station annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}openchargemap_lookup_reference — openchargemap-mcp-server: lookup reference
Advertised read-only
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. A connector name can resolve to several regional variants ("CCS" matches CCS Type 2 = 33 and CCS Type 1 = 32, the North American form) — pass every returned ID to find_stations as an array, not just the first. 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.
openchargemap_lookup_reference input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum entries to return when browsing or when a query matches several. Max 100; larger positive integers are clamped unless OPENCHARGEMAP_CLAMP_LIMITS=false."
},
"query": {
"type": "string",
"pattern": "\\S",
"description": "Name, title, code, or alias to resolve (e.g. \"CCS\", \"CHAdeMO\", \"Tesla\", \"Public\", \"France\", \"FR\"). Case-insensitive, matches on title, formal name, and known aliases. Omit to browse the entire category."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Entries to skip before the returned page, for reading past a truncated result. Repeat the same call with the nextOffset value the previous one reported. Applies to browsing and to a query with many matches alike; the order is stable, so every entry is reachable by paging."
},
"category": {
"enum": [
"connectiontypes",
"operators",
"usagetypes",
"statustypes",
"currenttypes",
"levels",
"countries"
],
"type": "string",
"description": "Which reference set to query. connectiontypes -> connectiontypeid; operators -> operatorid; usagetypes -> usagetypeid; statustypes -> statustypeid; currenttypes -> current type; levels -> charge level (1/2/3); countries -> ISO country."
}
},
"additionalProperties": false
}openchargemap_lookup_reference output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"category",
"matches",
"snapshotDate",
"source",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The limit that was applied."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Entries in the returned page."
},
"notice": {
"type": "string",
"description": "How to reach the entries this page left out."
},
"source": {
"enum": [
"live",
"bundled"
],
"type": "string",
"description": "Where these entries came from. \"live\" — 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": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title"
],
"properties": {
"id": {
"type": "number",
"description": "The reference ID for this entry."
},
"title": {
"type": "string",
"description": "Human-readable title (e.g. \"CCS (Type 2)\", \"ChargePoint\", \"United States\")."
},
"detail": {
"type": "string",
"description": "Extra interpretive context (operational flag, pay/membership/access, discontinued/obsolete, continent)."
},
"isoCode": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code — countries category only."
},
"formalName": {
"type": [
"string",
"null"
],
"description": "Formal/standard name where applicable. null when none."
}
},
"description": "A matching reference entry.",
"additionalProperties": false
},
"description": "Matching reference entries, best/exact match first."
},
"category": {
"type": "string",
"description": "The reference category queried."
},
"truncated": {
"type": "boolean",
"description": "True when matching entries were left out of the returned page."
},
"nextOffset": {
"type": "number",
"description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page."
},
"totalCount": {
"type": "number",
"description": "Entries matching before the offset/limit page was taken — the whole category when browsing, every match when a query was given."
},
"attribution": {
"type": "string",
"description": "Attribution to Open Charge Map contributors and station data providers; license terms vary by provider."
},
"filterParam": {
"type": "string",
"description": "The find_stations input parameter these IDs feed (e.g. \"connectiontypeid\"). Omitted for categories with no direct filter (currenttypes; countries use countrycode)."
},
"snapshotDate": {
"type": "string",
"description": "Date the reference data in this response was captured, so callers know its vintage — the day the live refresh ran when source is \"live\", the bundled snapshot's own capture date when source is \"bundled\". Read it together with source: the same date can mean either a fresh fetch or a freshly cut bundle."
}
},
"additionalProperties": false
}openchargemap_lookup_reference annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}openchargemap_get_station_comments — openchargemap-mcp-server: get station comments
Advertised read-onlyOpen-world
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.
openchargemap_get_station_comments input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric OCM station ID.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Comments to skip before the returned page, for reading past a truncated result. Repeat the same call with the nextOffset value the previous one reported. Ordering is newest-first and stable, but a check-in posted between pages shifts what a later offset lands on."
},
"maxresults": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum comments to return, newest first. Max 100; larger positive integers are clamped unless OPENCHARGEMAP_CLAMP_LIMITS=false."
}
},
"additionalProperties": false
}openchargemap_get_station_comments output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"stationId",
"stationTitle",
"comments",
"totalComments",
"attribution",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The maxresults cap that was applied."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found",
"upstream_unavailable",
"auth_failed"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: OCM returned an empty result for the given numeric ID (HTTP 200 with []) — 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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Comments in the returned page."
},
"notice": {
"type": "string",
"description": "How to reach the comments this page left out, or why the station has none on record."
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "string",
"description": "Commenter username. Absent for anonymous."
},
"rating": {
"type": [
"number",
"null"
],
"description": "User rating 1–5. null when not given."
},
"comment": {
"type": "string",
"description": "Comment text."
},
"relatedUrl": {
"type": "string",
"description": "Link the commenter attached. Absent when none was given."
},
"commentType": {
"type": "string",
"description": "Comment type (e.g. \"General Comment\", \"Fault Report\")."
},
"dateCreated": {
"type": "string",
"description": "ISO 8601 timestamp the comment was posted."
},
"checkinStatus": {
"type": "string",
"description": "The visit outcome the driver recorded (e.g. \"Charged Successfully\", \"Failed to Charge (Equipment Not Operational)\"). Carries the result on check-ins that have no comment text. Absent when the visitor recorded no outcome."
},
"checkinStatusId": {
"type": "number",
"description": "Numeric ID of the check-in outcome, stable across renames of its title."
},
"checkinStatusIsPositive": {
"type": "boolean",
"description": "Whether the registry classes this outcome as a good visit. Absent when the outcome carries no verdict either way (e.g. \"Did Not Visit Location\") or when none was recorded."
}
},
"description": "A community check-in or comment.",
"additionalProperties": false
},
"description": "The requested page of community comments, newest first — offset/maxresults applied. Empty with totalComments 0 means OCM has no check-ins for this station (absence of reports is not evidence the charger works); empty with a non-zero totalComments means the offset is past the last comment."
},
"stationId": {
"type": "number",
"description": "OCM station ID the comments belong to."
},
"truncated": {
"type": "boolean",
"description": "True when comments were left out of the returned page."
},
"nextOffset": {
"type": "number",
"description": "The offset to pass on an otherwise identical call to read the next page. Absent on the last page."
},
"totalCount": {
"type": "number",
"description": "Comments this station has on record, before the offset/maxresults page was taken — the complete count, not the page size."
},
"attribution": {
"type": "string",
"description": "Attribution to Open Charge Map contributors and station data providers; license terms vary by provider."
},
"stationTitle": {
"type": "string",
"description": "Station name, for context."
},
"isOperational": {
"type": "boolean",
"description": "Whether the registry marks the station operational. Absent when the operational state is unknown. Compare against the comments below — they are the real-world check."
},
"totalComments": {
"type": "number",
"description": "Comments this station has on record — the whole set, before offset/maxresults selected the page in comments. reliabilityNote counts its fault ratio over this population, not over the page."
},
"registryStatus": {
"type": "string",
"description": "Current registry operational status (operator-reported)."
},
"reliabilityNote": {
"type": "string",
"description": "A caveat when the registry status, verification age, coordinates, or comments suggest the listing may not reflect reality. Omitted when there is nothing to flag."
},
"dateLastVerified": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was last verified. null when never verified."
},
"registryStatusId": {
"type": "number",
"description": "Registry status ID — the value the openchargemap_find_stations statustypeid filter takes. Absent when OCM has no status on record."
}
},
"additionalProperties": false
}openchargemap_get_station_comments annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}Prompts
0 advertised
Resources
1 advertised
openchargemap-guide
Assess EV charging options with openchargemap_* tools. Use when recommending a compatible, accessible charger, checking conflicting reliability evidence, or deciding whether a station search covers the requested area.
openchargemap-guide URI
skill://openchargemap-guide/SKILL.mdopenchargemap-station — openchargemap-mcp-server: station record
Full Open Charge Map station record by numeric OCM ID, including community comments.
openchargemap-station URI template
openchargemap://station/{id}io.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 840 ms
- 95th percentile latency
- 840 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 840 ms · metadata changed · 4 tool(s), 1 resource(s), 2 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http openchargemap-mcp-server https://openchargemap.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add openchargemap-mcp-server --url https://openchargemap.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"openchargemap-mcp-server": {
"url": "https://openchargemap.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"openchargemap-mcp-server": {
"type": "streamableHttp",
"url": "https://openchargemap.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"openchargemap-mcp-server": {
"type": "http",
"url": "https://openchargemap.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http openchargemap-mcp-server https://openchargemap.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://openchargemap.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"openchargemap-mcp-server": {
"serverUrl": "https://openchargemap.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like openchargemap-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.