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
Schema
Input1
userIdstringREQUIRED
Output3
authorizedbooleanREQUIRED
userIdstringREQUIRED
conversationTokenstringREQUIRED
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
Schema
Input3
emailstring
userIdstring
channelenumREQUIRED
Output5
conversationTokenstringREQUIRED
userIdstringREQUIRED
channelenumREQUIRED
maskedDestinationstringREQUIRED
expiresAtstringREQUIRED
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. Requires a verified customer: if the conversation has none yet, ask for their email and run customer-request-verification, then customer-verify.

Customer
Verified customer
Conversation token
Required
Schema
Input
No parameters.
Output5
accountIdstring | nullREQUIRED
accountobject | nullREQUIRED
namestring | nullREQUIRED
currencystring | nullREQUIRED
tiernumber | nullREQUIRED
limitsobjectREQUIRED
currentMonthobjectREQUIRED
limitnumber | nullREQUIRED
usagenumberREQUIRED
usagePercentagenumber | nullREQUIRED
creditLimitExceededbooleanREQUIRED
verificationsobject | nullREQUIRED
completedobject[]REQUIRED
typeenumREQUIRED
labelstringREQUIRED
valuestring | nullREQUIRED
verifiedAtstring | nullREQUIRED
remainingobject[]REQUIRED
typeenumREQUIRED
labelstringREQUIRED
valuestring | nullREQUIRED
verifiedAtstring | nullREQUIRED
sessionsobjectREQUIRED
chargingCardsobjectREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
chargePointsobject | nullREQUIRED
activenumberREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
revenueobject[]REQUIRED
currencystring | nullREQUIRED
amountnumberREQUIRED
usersobject[]REQUIRED
namestring | nullREQUIRED
callerbooleanREQUIRED
limitsobjectREQUIRED
currentMonthobjectREQUIRED
limitnumber | nullREQUIRED
usagenumberREQUIRED
sessionsobjectREQUIRED
currentMonthobjectREQUIRED
countnumberREQUIRED
kwhnumberREQUIRED
durationSecondsnumberREQUIRED
chargePointsobjectREQUIRED
statsobject | nullREQUIRED
locationsnumberREQUIRED
chargePointsnumberREQUIRED
onlinenumberREQUIRED
offlinenumberREQUIRED
needsAttentionnumberREQUIRED
roamingEnablednumberREQUIRED
openIssuesnumberREQUIRED
connectorsobjectREQUIRED
chargingCardsobjectREQUIRED
statsobject | nullREQUIRED
chargingCardsobjectREQUIRED
totalnumberREQUIRED
activenumberREQUIRED
blockednumberREQUIRED
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
Schema
Input1
codestringREQUIRED
Output3
verifiedbooleanREQUIRED
conversationTokenstring
attemptsRemainingnumber