YoCharge Connector for Claude
Ask Claude about your charging network in plain language. The connector is read-only and only sees your own organization’s data.
What the connector does
The YoCharge connector links Claude to your YoCharge CPO Admin account through the Model Context Protocol (MCP). Once it’s connected, anyone on your team can ask Claude about stations, charging sessions and users and get answers from live data, without opening dashboards or building an API integration.
Every request runs under your own YoCharge account and its permissions. The connector does not keep a copy of your data: each question becomes a live, read-only request to the YoCharge platform.
Tools
All tools are read-only. None of them can create, change or delete anything, so Claude can’t start or stop a charger, change a tariff or edit a user through this connector.
| Tool | What it returns |
|---|---|
| List Properties | The stations (locations) in your network nearest to a location you give, closest first, a page at a time. With “only available” on, it searches across networks, including roaming partner locations, and returns only stations with an online charger and a free connector, so a page may hold fewer stations. |
| List Transactions | Charging sessions, filtered by date range, station, charger, status, session ID or a search term. |
| Get Transaction Details | The full record of one charging session. |
| List Users | The user accounts in your organization: drivers, and also your own admin and staff accounts. Filter by email or mobile number, sign-up date or status (active or blocked). Results include each user’s email address and mobile number. |
Example questions
- “Which of our stations had the most sessions last week?”
- “Show me failed sessions at our airport site between 1 and 7 October.”
- “Is there an available charger within 5 km of this address right now?”
- “Find the driver with this email and show their recent sessions.”
Before you start
On the YoCharge CPO Admin portal, under For Developers → AI Integrations, check that:
- AI Integrations is enabled for your organization.
- API access is enabled for your organization.
- You have your YoCharge CPO Admin login: the same email and password you use for the portal.
If either setting is off, ask your YoCharge account manager or email support@yocharge.com.
Connect YoCharge to Claude
- In Claude, open Settings → Connectors and browse the connector directory.
- Find YoCharge and click Connect.
- Claude sends you to the YoCharge sign-in page.
- Sign in with your YoCharge CPO Admin email and password.
- Review the access requested and click Approve.
- You’re returned to Claude, and the connector is ready to use.
How sign-in works
Connecting uses OAuth 2.1 (authorization code flow with PKCE):
- You sign in on YoCharge’s own page. Your password is never shared with Claude or Anthropic.
- Approving issues an access token scoped to your organization. Claude uses it to call the tools on your behalf.
- Access tokens last 30 days and refresh tokens 90 days, unless you revoke them sooner.
Query limits
These limits are enforced so answers stay fast and complete.
| Query | Limit |
|---|---|
| Charging sessions and users, by date | At most 7 days per query. Ask for a longer period and Claude splits it into 7-day queries. |
| Charging sessions and users, no filters | 10 records per page. Claude asks for the next page when it needs more. |
When a request goes past a limit, the connector returns an error explaining how to narrow it. It never silently cuts results short.
What the connector can’t answer
The connector doesn’t expose wallet balances, revenue reports or support tickets. Claude will say so rather than guess.
Revoke access
Revoke Claude’s access at any time from For Developers → AI Integrations in the CPO Admin portal. The token stops working immediately, and your other API keys and integrations are not affected. You can also remove the connector in Claude under Settings → Connectors.
Troubleshooting
| Problem | Likely cause |
|---|---|
| YoCharge isn’t offered or the connection fails straight away | AI Integrations or API access isn’t enabled for your organization yet |
| The sign-in page rejects your login | Use your CPO Admin portal login, not a sub-user or an API key |
| The redirect back to Claude hangs | Try connecting again. If it keeps happening, email support@yocharge.com with the approximate time |
| Claude says a date range is too long | Ask for 7 days or less, or let Claude split the period |
Privacy and support
- What the connector stores and shares: YoCharge MCP Connector Privacy Policy
- Help: support@yocharge.com
- Building your own integration instead: EV Charging API and Webhooks
Questions? Email support@yocharge.com