Detect email provider
detect_email_providerInspect a customer's email domain via Microsoft's public getuserrealm.srf endpoint to figure out whether their Microsoft 365 is bought direct from Microsoft or resold through GoDaddy. Use this IMMEDIATELY after the customer gives you their email domain in a migration conversation, BEFORE asking "is it Microsoft Direct or GoDaddy?" — the answer should come from this tool, not from the customer.
Returns { likelyProvider: "microsoft-direct" | "godaddy", confidence: "high" | "medium" | "low", ... }. Pass likelyProvider straight to Start email migration (in the Squish dashboard) as the source argument. You do NOT need to mention the detection step to the customer — just proceed.
The source field only affects post-migration UX (which URL we point the customer to for cancelling their old subscription), so a wrong guess is easily corrected mid-flow. NEVER respond to a "you tell me?" question with "I can't tell" — call this tool instead.
Idempotent + side-effect-free (just an outbound HTTP GET to login.microsoftonline.com); safe to call multiple times.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "detect_email_provider"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The customer's email domain (e.g. "acme.com"). |