list_top_posts

mcp:readread-only

The best-performing published posts over the last days (default 30), ranked by engagement. Returns { items, page, limit, total, hasMore }: limit is per page (default 10, max 50), page is 1-based; call again with page + 1 while hasMore is true.

Input

• daysinteger

  min 1 · max 365 · default 30

• pageinteger

  1-based page number. Use with limit; hasMore says whether another page exists.

  min 1 · default 1

• limitinteger

  min 1 · max 50 · default 10

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": "list_top_posts",
    "arguments": {}
  }
}

Same action over the REST API

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