microsoft_ads_check_auth_status

Description

THE tool for questions about Microsoft Ads authentication and connection status. Returns: - Whether the user has a connected Microsoft Ads OAuth token - Whether MICROSOFT_ADS_DEVELOPER_TOKEN is configured on the server (a server-side requirement that no data tool can report) - Microsoft Ads user info (name, login) when authenticated - List of all accessible ad accounts when authenticated Call this tool directly whenever the user's question IS about auth/connection/token status — e.g. "Am I authenticated?", "Is my Microsoft Ads account connected?", "Check my connection", "Diagnose my auth / MISSING_DEVELOPER_TOKEN error". It is the authoritative connection check and reports the developer-token configuration, which microsoft_ads_list_accounts cannot. Do NOT substitute a data tool like list_accounts to "prove" a connection when the user explicitly asked about auth status. Do NOT call it proactively before a data request the user actually made: if the user asks for their accounts/campaigns/etc., call that data tool directly, and only fall back to this tool reactively if the data tool fails with an auth or permission error (codes 105 InvalidCredentials, 106 UserIsNotAuthorized, 109 AuthenticationTokenExpired). Code 117 is rate limiting, not auth — wait and retry instead.

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_check_auth_status",
    "arguments": {
      "reason": "microsoft_ads_list_campaigns returned an authentication error; checking connection status"
    }
  }
}

hopkin microsoft auth check

{
  "mcpServers": {
    "microsoft-ads": {
      "url": "https://microsoft.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Examples

{
  "reason": "microsoft_ads_list_campaigns returned an authentication error; checking connection status"
}

{
  "reason": "Got error code 106 (UserIsNotAuthorized); checking if Microsoft Ads account is connected"
}

{
  "reason": "Received MISSING_DEVELOPER_TOKEN error; verifying server environment configuration"
}

Related Tools