GnistAI GnistAI
Log in

Getting Started with EV Charging

EV charging networks, connector types, and charging levels reference data.

All Tutorials   |   Overview   |   Playground   |   MCP   |   REST API   |   Home
Automotive

Data source: Curated dataset (industry sources)

Overview

EV Charging wraps Curated dataset (industry sources), handling authentication, pagination, and rate limits for you. This tutorial covers all 8 tools with working code examples you can copy and run.

Prerequisites

  1. Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
  2. Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config 
{
  "mcpServers": {
    "gnist-ev-charging": {
      "url": "https://context.gnist.ai/mcp/ev-charging/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (8)

get_charging_network

Get detailed information about an EV charging network. Returns name, country coverage, connector types, pricing model, station count, and description.

ParameterTypeRequiredDescription
network_idstringrequiredNetwork ID slug (e.g. tesla-supercharger, chargepoint, ionity).
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_charging_network", "arguments": {"network_id": "tesla-supercharger"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'network_id': 'tesla-supercharger'},
            'name': 'get_charging_network'}},
)
print(resp.json())

search_charging_networks

Search the EV charging network database.

ParameterTypeRequiredDescription
querystringrequiredSearch by network name or description.
limitintegeroptional (default: 20)
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_charging_networks", "arguments": {"query": "renewable energy"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'query': 'renewable energy'},
            'name': 'search_charging_networks'}},
)
print(resp.json())

list_networks_by_country

List EV charging networks operating in a specific country.

ParameterTypeRequiredDescription
countrystringrequiredCountry name (e.g. United States, Germany, Norway).
limitintegeroptional (default: 50)
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_networks_by_country", "arguments": {"country": "United"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'country': 'United'},
            'name': 'list_networks_by_country'}},
)
print(resp.json())

get_connector_type

Get detailed information about an EV charging connector type. Returns standard, max power, voltage range, current type, regions, and description.

ParameterTypeRequiredDescription
connector_idstringrequiredConnector ID slug (e.g. ccs1, ccs2, chademo, type-2, nacs).
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_connector_type", "arguments": {"connector_id": "ccs1"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'connector_id': 'ccs1'},
            'name': 'get_connector_type'}},
)
print(resp.json())

list_connector_types

List EV charging connector types, optionally filtered by current type.

ParameterTypeRequiredDescription
current_typeanyoptionalFilter by current type: AC or DC.
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_connector_types", "arguments": {"current_type": "example"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'current_type': 'example'},
            'name': 'list_connector_types'}},
)
print(resp.json())

get_charging_level

Get detailed information about an EV charging level. Returns power range, typical charge time, use case, compatible connectors, and description.

ParameterTypeRequiredDescription
level_idstringrequiredLevel ID slug (e.g. level-1, level-2, dc-fast).
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_charging_level", "arguments": {"level_id": "level-1"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'level_id': 'level-1'}, 'name': 'get_charging_level'}},
)
print(resp.json())

list_charging_levels

List all EV charging levels (Level 1, Level 2, DC Fast Charging).

curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_charging_levels", "arguments": {}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {}, 'name': 'list_charging_levels'}},
)
print(resp.json())

report_feedback

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: general)
curl -X POST "https://context.gnist.ai/mcp/ev-charging/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/ev-charging/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Search then retrieve
Use search_charging_networks to find items, then get_charging_network to get full details. This two-step pattern is common for exploring data before drilling down.
Pagination
Several tools support limit, offset, or page parameters. Start with small limits during development, then increase for production queries.

FAQ

What data does EV Charging provide?

EV charging networks, connector types, and charging levels reference data. It exposes 8 tools: get_charging_network, search_charging_networks, list_networks_by_country, get_connector_type, list_connector_types, get_charging_level, list_charging_levels, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the EV Charging API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.

Next Steps

Interactive Playground
Try tools in your browser — no setup required.
Full Reference
Complete docs for all 8 tools.

Related Tutorials

VIN Lookup
Tutorial
Vehicle Specifications
Tutorial
Electric Vehicle Data
Tutorial