Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Openchargemap MCP Server

by cyanheadsversion 0.2.0i★ 2iComputer or cloudOfficial site ↗
Registry nameio.github.cyanheads/openchargemap-mcp-server

How to install

What it does

Find EV charging stations, detail, and reliability check-ins via the global Open Charge Map.

  • Connects Computer or cloud
  • Account or key Cloud: No key needed · Local: Needs OPENCHARGEMAP_API_KEY
  • Category Travel, maps & weather

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score26/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Openchargemap MCP Server. Follow https://mcp.popnx.com/i/cyanheads-openchargemap-mcp-server.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (openchargemap.caseyjhand.com) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameOpenchargemap MCP Server
    Remote MCP server URL · Addresshttps://openchargemap.caseyjhand.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsOpenchargemap MCP Server

  4. Try it

    Use Openchargemap MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Openchargemap MCP Server or shows a Openchargemap MCP Server tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameOpenchargemap MCP Server
    Connection · Addresshttps://openchargemap.caseyjhand.com/mcp
  3. Pick Openchargemap MCP Server in a chat

    Start a new chat and pick Openchargemap MCP Server from your plugins before typing

  4. Try it

    Use Openchargemap MCP Server and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Openchargemap MCP Server or shows a Openchargemap MCP Server tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user openchargemap https://openchargemap.caseyjhand.com/mcp
  3. Type /mcp in Claude Code

    You should see Openchargemap MCP Server listed as connected

  4. Try it

    Use Openchargemap MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Openchargemap MCP Server or shows a Openchargemap MCP Server tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Openchargemap MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Openchargemap MCP Server or shows a Openchargemap MCP Server tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Openchargemap MCP Server and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Openchargemap MCP Server or shows a Openchargemap MCP Server tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://openchargemap.caseyjhand.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Openchargemap MCP Server💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user openchargemap https://openchargemap.caseyjhand.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "openchargemap": {
      "url": "https://openchargemap.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "openchargemap": {
      "type": "http",
      "url": "https://openchargemap.caseyjhand.com/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user openchargemap --env OPENCHARGEMAP_API_KEY=your-value -- npx -y @cyanheads/openchargemap-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "openchargemap": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openchargemap-mcp-server"
      ],
      "env": {
        "OPENCHARGEMAP_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "openchargemap": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openchargemap-mcp-server"
      ],
      "env": {
        "OPENCHARGEMAP_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "openchargemap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openchargemap-mcp-server"
      ],
      "env": {
        "OPENCHARGEMAP_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • OPENCHARGEMAP_CLAMP_LIMITS env
    Clamp oversized positive integer page sizes to the tool maximum; false restores rejection.
  • OPENCHARGEMAP_API_KEY secret required env
    Open Charge Map API key, sent as the X-API-Key header on every request. Free instant signup at openchargemap.org.
  • OPENCHARGEMAP_BASE_URL env
    Override the OCM API base URL (default https://api.openchargemap.io/v3). For a private mirror or testing.
  • OPENCHARGEMAP_REFERENCE_REFRESH env
    When true, refresh reference data from the live /referencedata endpoint at startup, falling back to the bundled snapshot on failure.
  • MCP_LOG_LEVEL env
    Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
115/wk
Licencei
Apache-2.0
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.2.0
Published to registryi
Oct 26, 2026
Code last changedi
Oct 26, 2026
Last checked
Nov 17, 2026
Maker
cyanheads
Packages
npm: @cyanheads/openchargemap-mcp-server
npm: @cyanheads/openchargemap-mcp-server
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 17, 2026. The maker wrote them, not us; we show them as plain text.

  • openchargemap_find_stations

    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 geocod

  • openchargemap_get_station

    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 cha

  • openchargemap_lookup_reference

    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 us

  • openchargemap_get_station_comments

    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", "Faile

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 18, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account cyanheads, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 23 days ago

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • ✓ Pass

    Endpoint responds

    Responded in 568 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 4 tool descriptions and found no hidden instructions to the AI

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @cyanheads/openchargemap-mcp-server@0.2.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-openchargemap-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-openchargemap-mcp-server)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Travel, maps & weatheri

  • More stars than 92% of the other 1994 servers in this category
  • Published to the registry more recently than 56% of the other 1994 servers in this category
  • Basic checks equal to or better than 99% of the other 1994 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Openchargemap MCP Server safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: OPENCHARGEMAP_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 23 days ago, and the latest version (0.2.0) reached the registry 23 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Mu, Award Travel Finder, Killbottleneck, Whimsical, HasData Google Maps

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

by microGrowing★ 440Updated 4 months ago

Runs in the cloud✓ micro.mu

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

by WhimsicalCodeEarly★ 11Updated 2 months ago

Runs in the cloud✓ service owner · whimsical.com

HasData Google Maps

Google Maps places, reviews, contributor history, photos and posts as JSON. No Google Cloud.

by HasDataEarly↓ 107/wk★ 10Updated 2 months ago

Computer or cloud✓ service owner · hasdata.com
Compared with similar ones
This one
Openchargemap MCP Server
MuAward Travel FinderKillbottleneckWhimsicalHasData Google Maps
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyYesNoNoYesNoYes
Add with + in ClaudeNoNoNoNoYesNo
Basic checks5/54/43/33/34/45/5
LicenseApache-2.0AGPL-3.0MITMITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@cyanheads/openchargemap-mcp-server Find EV charging stations worldwide by location and connector from the global Open Charge Map registry — full station detail, reference-ID resolution, and community reliability check-ins via MCP. STDIO or Streamable HTTP. 4 Tools • 2 Resources

Public Hosted Server: https://openchargemap.caseyjhand.com/mcp


Overview

EV charging stations worldwide from Open Charge Map. Search by location, connector, and network, pull full station detail, and read community check-ins on whether a charger actually works.

Tools
ToolDescription
openchargemap_find_stationsFind charging stations near a point or within a bounding box, filtered by connector, power, network, usage, status, and charge points. Coordinate-native.
openchargemap_get_stationFull record for one station by numeric OCM ID — every connection, operator, access rules, charge points, cost, media, and a computed reliability note.
openchargemap_lookup_referenceResolve connector/operator/usage/status/country names to the integer filter IDs find_stations needs. Served from a bundled snapshot — offline and instant.
openchargemap_get_station_commentsCommunity check-ins for one station alongside the registry status and last-verified date, so registry-vs-reality mismatch is visible.
Resources
ResourceDescription
openchargemap://station/{id}Full station record (with community comments) by numeric OCM ID — the URI-addressable twin of openchargemap_get_station.
skill://openchargemap-guide/SKILL.mdGuide to recommending compatible, accessible chargers, assessing reliability evidence, and checking search coverage. Also ships with plugin, npm, Docker, and MCPB installs.

All station data is also reachable via the tools; the station corpus (~200k locations, geo-scoped) isn't exposed as a listable resource, and reference data is served by openchargemap_lookup_reference rather than a resource.

Capability reference

openchargemap_find_stations tool
  • Radius search (latitude + longitude + distance, distanceUnit KM or Miles, max 500) or boundingbox — exactly one mode per call; optional countrycode (ISO 3166-1 alpha-2) and filters connectiontypeid, minpowerkw, operatorid, usagetypeid, levelid, statustypeid, minchargepoints (the ID filters take one integer ID or an OR-matched array, resolved via openchargemap_lookup_reference)
  • maxresults caps the page (default 25, max 200) and offset pages through a fixed cached pool of up to 500 candidates per search. A 501st record only detects an upstream remainder: totalCount is exact without that sentinel and a floor when it is present; the notice says which
  • No matches returns a successful empty list with search recovery guidance. Unknown country codes are not applied and are disclosed in the summary and notice. Fails with invalid_location (no search area, half a center, or a coordinate beside a boundingbox), auth_failed, or upstream_unavailable

openchargemap_get_station tool
  • Full record for one station by numeric OCM id — every connection, operator/network, usage and access rules, charge-point count, usage cost, data provider, media, and dateLastVerified; includeComments adds every check-in inline, unpaged (use openchargemap_get_station_comments for a heavily-commented station)
  • reliabilityNote is plain prose computed from observable facts (verification age, registry status, operational flag, fault-vs-positive check-ins), omitted when there is nothing to flag; fails with not_found, auth_failed, or upstream_unavailable

openchargemap_lookup_reference tool
  • category (connectiontypes, operators, usagetypes, statustypes, currenttypes, levels, countries) plus an optional case-insensitive query naming a title, code, or alias ("CCS", "Tesla Supercharger", "FR"); omit query to browse the category (limit max 100, default 25, paged via offset/nextOffset)
  • Returns the matching id(s), the filterParam they feed into openchargemap_find_stations, and source (live or bundled) with a snapshotDate — answered offline from the bundled snapshot unless OPENCHARGEMAP_REFERENCE_REFRESH refreshed it at startup. A miss returns a successful empty list with spelling/browse guidance

openchargemap_get_station_comments tool
  • Check-ins for one station by numeric OCM id, newest first, each with rating, date, and recorded outcome — maxresults caps the page (default 25, max 100), paged via offset/nextOffset; totalComments counts the station's whole set, and reliabilityNote's fault ratio is computed over all of it
  • Returns the registry status, isOperational, and dateLastVerified beside the comments; an empty comments: [] is not an error (no reports is not evidence the charger works); fails with not_found, auth_failed, or upstream_unavailable

openchargemap://station/{id} resource
  • Full record for one station by numeric OCM ID, community comments always included — the URI-addressable twin of openchargemap_get_station, cached for 600 seconds, and not listable
  • Fails with not_found when the ID doesn't resolve to a station

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

Open Charge Map-specific:

  • Type-safe client for the OCM v3 POI API with retry and session-scoped result caching
  • Reference data (connectors, operators, usage/status types, countries) bundled as an offline snapshot — name→ID resolution needs no live /referencedata call, with an optional startup refresh to prevent drift
  • Curated connector aliases (CCS, NACS/Supercharger, J1772, Type 2, CHAdeMO) so the names agents actually use resolve to the right IDs
  • Geocoding intentionally delegated — the server is coordinate-native and composes with any geocoding MCP server (e.g. the openstreetmap server's openstreetmap_search_places) rather than rebuilding place-name lookup
  • Stations are addressed by numeric OCM ID, discovered through openchargemap_find_stations — the OCM API has no UUID lookup

Agent-friendly output:

  • Reliability surfaced as first-class signal — status, statusTypeId, isOperational, and dateLastVerified on every station, plus a plain-prose reliabilityNote derived only from observable facts (no fabricated confidence score)
  • Honest sparsity — heavily-omitted upstream fields are optional with "absence means unknown, not zero/false" descriptions; the server never invents data OCM didn't return
  • Attribution to Open Charge Map contributors and station data providers on every response; per-station provider license terms and open-data flags when supplied

Getting started

Public Hosted Instance

A public instance is available at https://openchargemap.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP, with this client config:

{

"mcpServers": { "openchargemap-mcp-server": { "type": "streamable-http", "url": "https://openchargemap.caseyjhand.com/mcp" } } }

Self-Hosted / Local

Add the following to your MCP client configuration file. An Open Charge Map API key is required — see Prerequisites.

{

"mcpServers": { "openchargemap-mcp-server": { "type": "stdio", "command": "bunx", "args": ["@cyanheads/openchargemap-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info", "OPENCHARGEMAP_API_KEY": "your-api-key" } } } }

Or with npx (no Bun required):

{

"mcpServers": { "openchargemap-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@cyanheads/openchargemap-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info", "OPENCHARGEMAP_API_KEY": "your-api-key" } } } }

Or with Docker:

{

"mcpServers": { "openchargemap-mcp-server": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "-e", "OPENCHARGEMAP_API_KEY=your-api-key", "ghcr.io/cyanheads/openchargemap-mcp-server:latest" ] } } }

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 OPENCHARGEMAP_API_KEY=... bun run start:http

Server listens at http://localhost:3010/mcp

Prerequisites
  • Bun v1.4 or higher (or Node.js v24+).
  • An Open Charge Map API key — free instant signup: register an application at openchargemap.org. Sent as the X-API-Key header on every request; the server fails fast at startup if it's unset.
Installation
  1. Clone the repository:
git clone https://github.com/cyanheads/openchargemap-mcp-server.git
  1. Navigate into the directory:
cd openchargemap-mcp-server
  1. Install dependencies:
bun install
  1. Configure environment:
cp .env.example .env

edit .env and set OPENCHARGEMAP_API_KEY

Configuration

All configuration is validated at startup via Zod schemas in src/config/server-config.ts. Key environme

Only the beginning is shown; read the rest in the repo