Customer

customer-authorizeSTATE-CHANGING

Attach a customer to a new conversation without OTP. For trusted clients only - the operator must explicitly enable this tool on the MCPClient. Returns a conversationToken to thread on subsequent calls.

Customer
No verification needed
Conversation token
Optional
Permissions
-
Schema
Input1
userIdstringREQUIRED

The customer user ID to authorize

Output3
authorizedbooleanREQUIRED
userIdstringREQUIRED
conversationTokenstringREQUIRED

Thread this back on subsequent tool calls in this conversation.

customer-request-verificationSTATE-CHANGING

Send a one-time verification code to the customer via email or SMS. Look up the customer by email or by userId. The code expires in 5 minutes. Returns a conversationToken; thread it back on customer-verify (and subsequent tool calls). Available channels depend on the client configuration.

Customer
No verification needed
Conversation token
Optional
Permissions
-
Schema
Input3
emailstring

Customer email address

userIdstring

Customer user ID

channelenumREQUIRED

Delivery channel

Output5
conversationTokenstringREQUIRED

Thread this back as conversationToken on customer-verify (and any later tool calls in this conversation). The token binds the OTP challenge to a specific conversation; verification will fail if you start a new one.

userIdstringREQUIRED
channelenumREQUIRED
maskedDestinationstringREQUIRED
expiresAtstringREQUIRED

ISO timestamp when the code expires

customer-summaryREAD-ONLY

Returns an account-wide overview: account-level credit limits and charging activity this month (both the charging-cards and charge-points sides) with per-user limits, plus charge-point counts and fleet health and charging-card counts. Stats only: this tool does NOT list the individual charge points or charging cards, so for those call charge-points-summary or charging-cards-summary instead. Access is per section: account-level user read unlocks the other users and the account verifications; account-level card read makes the card stats cover the account rather than only the caller; charge-point stats are account-wide for every caller. For individual session records use charge-points-sessions or charging-cards-sessions.

Customer
Verified customer
Conversation token
Required
Permissions
-
Schema
Input
No parameters.
Output5
accountIdstring | nullREQUIRED
accountobject | nullREQUIRED
namestring | nullREQUIRED
currencystring | nullREQUIRED
tiernumber | nullREQUIRED
limitsobjectREQUIRED
currentMonthobjectREQUIRED
limitnumber | nullREQUIRED

Credit limit; null when none is set.

usagenumberREQUIRED

Usage within the period named by the holding field.

usagePercentagenumber | nullREQUIRED
creditLimitExceededbooleanREQUIRED
verificationsobject | nullREQUIRED
completedobject[]REQUIRED
typeenumREQUIRED
labelstringREQUIRED
valuestring | nullREQUIRED

The e-mail / phone / IBAN; null when not provided.

verifiedAtstring | nullREQUIRED

ISO timestamp when verified; null when not yet verified.

remainingobject[]REQUIRED
typeenumREQUIRED
labelstringREQUIRED
valuestring | nullREQUIRED

The e-mail / phone / IBAN; null when not provided.

verifiedAtstring | nullREQUIRED

ISO timestamp when verified; null when not yet verified.

sessionsobjectREQUIRED
chargingCardsobjectREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
chargePointsobject | nullREQUIRED
activenumberREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
revenueobject[]REQUIRED
currencystring | nullREQUIRED
amountnumberREQUIRED
usersobject[]REQUIRED
namestring | nullREQUIRED
callerbooleanREQUIRED

True for the calling user.

limitsobjectREQUIRED
currentMonthobjectREQUIRED
limitnumber | nullREQUIRED

Credit limit; null when none is set.

usagenumberREQUIRED

Usage within the period named by the holding field.

sessionsobjectREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
chargePointsobjectREQUIRED
statsobject | nullREQUIRED
locationsnumberREQUIRED

Distinct locations the account's charge points sit at.

chargePointsnumberREQUIRED
onlinenumberREQUIRED

Charge points with connectivityState "connected".

offlinenumberREQUIRED

Charge points not currently connected.

needsAttentionnumberREQUIRED

Charge points offline, reboot-required or disabled.

roamingEnablednumberREQUIRED

Charge points where roaming is on, i.e. a charge card from outside this platform is accepted. This is NOT a count of publicly listed or map-visible charge points; that is the location publishingMode, a separate setting.

openIssuesnumberREQUIRED

Total active (unresolved) issues across the account's charge points.

connectorsobjectREQUIRED

Connector count keyed by status.

chargingCardsobjectREQUIRED
statsobject | nullREQUIRED
chargingCardsobjectREQUIRED
totalnumberREQUIRED
activenumberREQUIRED

Charging cards with status "active".

blockednumberREQUIRED

Charging cards whose token is blocked.

customer-verifySTATE-CHANGING

Verify a customer by checking the one-time code they received. Requires the conversationToken returned by customer-request-verification. On success the conversation is upgraded to authorized and a refreshed conversationToken is returned; thread that one back on all subsequent tool calls.

Customer
No verification needed
Conversation token
Required
Permissions
-
Schema
Input1
codestringREQUIRED

The verification code the customer received

Output3
verifiedbooleanREQUIRED
conversationTokenstring

Refreshed conversation token (longer TTL) issued on successful verification. Replace the previous token with this one on subsequent calls.

attemptsRemainingnumber