The whoiam tool retrieves information about the currently authenticated user, their connected Madgicx team, and the status of the team's Google Ads refresh token.
Different from the Facebook whoiam
Each MCP server has its own whoiam tool. The Google Ads version reports your Google Ads token status; the Facebook version reports your Facebook token status. If both connectors are active in your client, the assistant will pick the right one based on context.
Overview
- Category Identity
- Parameters None required
- Authentication OAuth token
Use Cases
Verify Connection
Confirm your MCP client is properly connected to the Google Ads MCP server
Check Team Context
See which Madgicx team you're operating against
Google Ads Token Status
Verify a Google Ads refresh token is connected for the active team. Without one, all other tools will fail
Response
The tool returns a single human-readable message containing:
| Parameter | Type | Description |
|---|---|---|
user |
string |
Username (or email) and Madgicx user ID |
team |
string |
Team name, ID, and test-mode flag |
permissions |
number |
Number of permissions granted by the team's plan |
google_token |
string |
Masked Google Ads token (first 4 + last 4 characters), or " |
Example Response
Hi there, alice@example.com (ID: user_123abc). Your current team is Acme Marketing
(ID: team_456def, Test mode: False). You have 27 permissions. Google Ads token: ya29...QwEr
Usage Examples
Natural Language
What Madgicx team am I connected to?
Is my Google Ads token connected?
Show me my user information
Direct Query
{
"tool": "whoiam",
"arguments": {}
}
Error Handling
No authentication context
Error: No authentication context found. Please ensure you are authenticated.
Cause: The request reached the server without a valid OAuth context.
Solution: Reconnect the MCP client to obtain a fresh token.
Google token not set
The response will include Google Ads token: <not set>.
Cause: Your team does not have a Google Ads refresh token connected.
Solution: Connect a Google account in Settings → Ad Accounts → Google Ad Accounts before calling other tools.
Related
- Authentication OAuth flow details
- list_ad_accounts Next: discover your Google Ads customers