MadgicxMCP Docs
Tools

Identity

Tool for retrieving user identity and team information.

whoiam

The whoiam tool retrieves information about the currently authenticated user and their connected Madgicx team.

Overview

Category

Identity

Parameters

None required

Authentication

OAuth token

Use Cases

Verify Connection

Confirm your MCP client is properly connected to Madgicx

Check Permissions

Review which OAuth scopes have been granted

Facebook Token Status

Verify your Facebook integration is active

Response

PropTypeDefault
user_id
string
-
team_id
string
-
permissions
string[]
-
facebook_token
object
-

Facebook Token Object

PropTypeDefault
status
"active" | "expiring" | "expired"
-
expires_at
string
-

Example Response

{
  "user_id": "user_123abc",
  "team_id": "team_456def",
  "permissions": ["mcp:read", "mcp:write"],
  "facebook_token": {
    "status": "active",
    "expires_at": "2024-12-31T23:59:59Z"
  }
}

Usage Examples

Ask your AI assistant naturally:

What Madgicx team am I connected to?
Show me my user information
Is my Facebook connection active?

Error Handling

Authentication

OAuth flow details

API Reference

HTTP endpoints

Previous

Available Tools

Next

Ad Account Tools

On this page

whoiamOverviewUse CasesVerify ConnectionCheck PermissionsFacebook Token StatusResponseFacebook Token ObjectExample ResponseUsage ExamplesError HandlingRelated