Skip to navigation

MCP

Give an AI agent the OCPPLab API as tools over the Model Context Protocol.

The OCPPLab API serves its operations as MCP tools. Agents such as Claude Code, Codex, Cursor, VS Code, claude.ai and ChatGPT can deploy virtual chargers, manage CPO and eMSP data, run OCPI roaming, and more, with your permissions.

  • Transport: Streamable HTTP
  • URL: https://api.ocpplab.io/mcp, or one server per domain at /mcp/<domain>
  • Auth: browser sign-in (OAuth), or an SDK token as Authorization: Bearer <token>

Connect in one command

claude mcp add --transport http ocpplab https://api.ocpplab.io/mcp

Run /mcp in Claude Code and pick ocpplab. Your browser opens: sign in, choose the organization the agent may use, and select Allow. Other clients: Connect a client.

Pick the servers you need

Every connected server adds its tool list to the agent’s context. Connect only the domains your task needs:

ServerURLCovers
ocpplab-evcharger/mcp/evchargerVirtual charger deployments, OCPP commands, logs, charger catalog, templates
ocpplab-ocpi/mcp/ocpiOCPI partners, credentials handshake, CPO and eMSP data, push and pull
ocpplab-cpo/mcp/cpoCharge points, EVSEs, connectors, locations, tariffs, sessions, CDRs, customers, AFIR
ocpplab-emsp/mcp/emspTenant profile, roaming identities, networks, tokens, token groups, commands
ocpplab-proxy/mcp/proxyProxy charger points, tokens, OCPP and OCPI commands
ocpplab-booking/mcp/bookingBookable locations and bookings
ocpplab-energy/mcp/energyPower-limit requests and power measurements
ocpplab-webhook/mcp/webhookWebhook endpoints, test deliveries, delivery history
ocpplab/mcpEvery domain above in one server

Tool counts and every tool name, per server: Servers and tools.

How tools behave

  • Names are <domain>_<operation>, for example cpo_charge_points_list or evcharger_start_session.
  • Permissions are yours: a tool call runs as the REST call it maps to, with your token. Results only include your organization, and admin tools return 403 unless you are an admin.
  • Hints: every tool says whether it is read-only, destructive or idempotent, so your client can ask before a destructive call.
  • Long-running tools return a tracking id, and their description names the tool to poll. See Long-running operations.
  • Updates: omit a field to leave it unchanged, or send null to clear it.
  • Limits: 120 calls per minute per user and organization, shared by every MCP URL. Over it, tools return 429 with Retry-After.
  • REST only: proxy backends, proxy routing rules and bulk log deletion are not MCP tools.

Agent skills

Give your coding agent OCPPLab know-how as agent skills: how to authenticate, deploy and drive virtual chargers, use the SDKs and the CLI, and connect MCP. One command installs them for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode and other agents:

npx skills add ev-cloudx/ocpplab-skills

Two MCP servers, two jobs

Product MCPDocs MCP
URLhttps://api.ocpplab.io/mcphttps://docs.ocpplab.io/_mcp/server
Gives the agentYour OCPPLab data and actionsAnswers from this documentation
Needs sign-inYesNo

Connect both when you want an agent to look up how something works and then do it.