Research & Benchmarks Optimization AI Ads Analytics Why Madgicx? About Us Blog Careers Case Studies Events Glossary Guides Answers Pricing Login Try for Free
MCP docs menu

Google Ads MCP whoiam Tool: Identity and Token Status

Tool for retrieving user identity, team info, and Google Ads token status.

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

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

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 "" if no token is connected

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.

Official Meta Business Partner

Connect your AI assistant to your ad accounts. The 7-day free trial includes both MCPs.

Sign in with your Madgicx login, add the server addresses and ask in plain words. Meta changes wait for your confirmation, and the Google Ads MCP only reads.

Try for Free ($0 Trial)
200,000+ advertisers
$10B+ annual ad spend visibility
4.6 / 5 on G2, from 220+ reviews