Skip to content

get_x_account_analytics

mcp:readread-only

Whole-account analytics for the connected X account over the last days (default 30), counting every post and reply on the account, not only ones published through AdVentur.ai: impressions, engagements and engagement rate, profile visits, link clicks, likes, reposts, replies received, bookmarks, posts and replies made per day, and followers with their net change. Each post counts on the day it went out. Compare totals with previous (the window before, null when tracking didn't cover it). enabled false means the workspace hasn't switched on the daily X sync yet; it's switched on from the Analytics page because the reads cost usage credits.

X doesn't share shares, verified followers or active followers.

Input

  • daysinteger

    min 1 · max 90 · default 30

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_x_account_analytics",
"arguments": {}
}
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/analytics/x-account as the signed-in user, with the same validation, approval rules and limits. See it in the Analytics API reference.