Skip to navigation

EV Cloud developer docs

Manage your CPO and eMSP data, charger power limits, webhooks and OCPI roaming from code or the terminal.

EV Cloud is one API in front of the EV charging gateways: your charging infrastructure as a CPO, driver tokens as an eMSP, energy limits on chargers, webhooks, and OCPI roaming with partners.

Pick the way you want to call it:

TypeScript SDK

npm i evcloud-sdk. Typed client for Node.js and the browser.

Python SDK

pip install evcloud-sdk. Sync and async clients.

CLI

evcloud-cli: one command per API operation, with browser sign-in.

MCP server

https://api.ev-cloud.ai/mcp: every operation as a tool for AI agents.

Start here

1

Get a token

Use an SDK token that expires, or sign in with evcloud-cli auth login. See Authentication.

2

Point the client at your EV Cloud host

The production API is https://api.ev-cloud.ai: pass it as the base URL. See Concepts.

3

Make a call

List your CPO locations with the TypeScript or Python SDK, or evcloud-cli cpo locations list.

What the API covers

DomainWhat you can do
cpoManage your charge points, EVSEs, connectors, locations, tariffs, sessions and CDRs
emspManage driver tokens, token groups, partner location networks and roaming identities
energySet power limits on chargers and read their power measurements
webhooksReceive events on your HTTPS endpoints
ocpiRegister OCPI partners, run the credentials handshake, push and pull roaming data

Each domain is a namespace in the SDKs (client.cpo...) and a command group in the CLI. See Concepts.