> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ev-cloud.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ev-cloud.ai/_mcp/server.

# EV Cloud developer docs

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](/sdks/typescript)

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

#### [Python SDK](/sdks/python)

`pip install evcloud-sdk`. Sync and async clients.

#### [CLI](/cli/overview)

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

#### [MCP server](/agents/mcp-server)

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

## Start here

#### Get a token

Use an SDK token that expires, or sign in with `evcloud-cli auth login`. See [Authentication](/get-started/authentication).

#### 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](/get-started/concepts#environments).

#### Make a call

List your CPO locations with the [TypeScript](/sdks/typescript) or [Python](/sdks/python) SDK, or `evcloud-cli cpo locations list`.

## What the API covers

| Domain     | What you can do                                                                      |
| ---------- | ------------------------------------------------------------------------------------ |
| `cpo`      | Manage your charge points, EVSEs, connectors, locations, tariffs, sessions and CDRs  |
| `emsp`     | Manage driver tokens, token groups, partner location networks and roaming identities |
| `energy`   | Set power limits on chargers and read their power measurements                       |
| `webhooks` | Receive events on your HTTPS endpoints                                               |
| `ocpi`     | Register 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](/get-started/concepts).