SpotCharge

Model Context Protocol

Query SpotCharge from any AI agent

SpotCharge exposes a public, read-only Model Context Protocol server. Connect Claude Desktop, ChatGPT (via connectors), Cursor, or any MCP-aware client. Seventeen tools cover charger search, site detail, source attribution, regional statistics, EV registrations, adoption-vs-infrastructure density, EV vehicle specs, charging-cost estimates, and a one-shot trip planner — backed by owner-managed listings plus imports from OpenChargeMap and the NREL Alternative Fuels Data Center.

Connect your agentBrowse the 17 tools

Endpoint

https://spotcharge.io/api/v1/mcp

Streamable HTTP transport. POST JSON-RPC payloads. No authentication required for the public read-only tools. Rate-limited at 60 requests per minute per IP.

Legacy alias

https://spotcharge.io/api/mcp

Kept working for early adopters. Prefer the versioned URL going forward — future v2 forks only the /api/v1 path.

Connect your agent

Two configuration patterns. Most modern clients support direct Streamable HTTP; older ones need an stdio bridge.

Direct (Claude Desktop, Cursor, Windsurf, ChatGPT custom GPT connectors, MCP Inspector)

Add to your client’s MCP config:

{
  "mcpServers": {
    "spotcharge": {
      "url": "https://spotcharge.io/api/v1/mcp"
    }
  }
}

Via mcp-remote (stdio-only clients)

Bridges Streamable HTTP through stdio for clients that don’t speak HTTP yet:

{
  "mcpServers": {
    "spotcharge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://spotcharge.io/api/v1/mcp"]
    }
  }
}

Sanity-check from the terminal

List every tool the server exposes:

curl -X POST https://spotcharge.io/api/v1/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Tools

17 read-only tools, grouped by what they answer. Full input schemas are returned by the tools/list RPC method — your client renders them automatically.

Find chargers

find_chargers_near

Geo-search by free-form address (auto-geocoded) or coordinates, sorted by distance.

search_chargers

Paginated directory search by city, state, network, connector, or kW.

get_site

Full detail for one site by code: stations, ports, photos, amenities, reviews, hours, pricing.

plan_charging_stop

One-shot trip planner — address + vehicle + SOC → ranked nearby chargers each annotated with estimated minutes + cost.

Industry context

list_networks

Distinct network operators (with counts) for a state or nationwide.

get_directory_stats

Footprint snapshot — site/station/port counts, DCFC vs L2, top networks, source breakdown, freshness.

get_electricity_price

Retail $/kWh by state and sector with 12-month trend (EIA Open Data).

lookup_vehicle

EV specs by year/make/model — range, MPGe, 240V charge time, estimated battery kWh (fueleconomy.gov).

estimate_charge_time

Pure-compute charge-time estimator — linear to 80%, then taper.

get_charging_cost_estimate

Combines EIA $/kWh + battery + state-of-charge to estimate session cost ($) and minutes.

compare_states

Side-by-side stats for 2-6 states in one call (sites, DCFC, top networks, source breakdown).

get_ev_registrations

Light-duty BEV + PHEV registration counts by state with national rank (AFDC, sourced from Experian).

get_charger_density

EV adoption vs charger build-out — sites per 1k EVs, DCFCs per 1k EVs, EVs per DCFC. Composes registrations + charger counts.

Geo navigation

list_states

Every state with ≥1 active site, with counts.

list_cities

Cities in a state with ≥1 active site, with counts.

Editorial

list_blog_posts

Index of charging guides and regional roundups.

get_blog_post

Full post content for a given slug.

Source attribution on every result

SpotCharge merges three upstreams into one directory:

Every site result includes data_source, confirmed_at, and external_ids (cross-references to OCM POI ID and NREL station ID), so agents can cite provenance accurately.

Status & limits

  • Public, read-only. No authentication required.
  • 60 requests / minute / IP. Returns 429 with Retry-After.
  • Static lists (states, cities, networks, blog index, directory stats) are cached 1 hour.
  • Free-form geocoding via OpenStreetMap Nominatim with 1.1s/req throttle.
  • /api/v1/mcp is the canonical URL. /api/mcp is a legacy alias kept for early adopters.

Found a bug or want a tool that doesn’t exist? Get in touch.