[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Get message analytics

> Message Analytics rows per campaign and automation: sends, clicks, orders, revenue and unsubscribes. Input schema, a tools/call example and an example result.

Source: https://cotlet.dev/docs/mcp/postscript/get_message_analytics

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Message Analytics rows per campaign and automation: sends, clicks, orders, revenue and unsubscribes.

Postscript MCP tools: https://cotlet.dev/docs/mcp/postscript.md

MCP tool: `postscript_read → get_message_analytics`

Access: read.

Reads Data & Insights > Messages for the date range, one row per message flow with the columns Postscript shows: Messages Sent, Total Clicks, Unique Clicks, Click-Through Rate (CTR), Orders, Revenue, Total Unsubscribes and Unsubscribe %. Postscript updates the data every 15 minutes, and Total Unsubscribes counts only opt-outs attributed to an automation or campaign. To read a calendar month, use its exact first and last day. Works on all Postscript plans.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `from` | date | no | First day of the range. |
| `to` | date | no | Last day of the range. |
| `group_by` | enum | no | day, week or month.. |
| `sort_by` | string | no | Column to sort by, for example Revenue.. |

## tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "postscript_read",
    "arguments": {
      "operation": "get_message_analytics",
      "arguments": {}
    }
  }
}
```

## Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "from": "2026-10-12",
    "to": "2026-10-18",
    "rows": [
      {
        "name": "VIP drop",
        "type": "campaign",
        "messages_sent": 4120,
        "total_clicks": 988,
        "unique_clicks": 802,
        "orders": 37,
        "revenue": 2310,
        "total_unsubscribes": 21,
        "unsubscribe_pct": 0.5
      },
      {
        "name": "Win-back for quiet subscribers",
        "type": "campaign",
        "messages_sent": 3412,
        "total_clicks": 301,
        "unique_clicks": 260,
        "orders": 21,
        "revenue": 1840,
        "total_unsubscribes": 34,
        "unsubscribe_pct": 1
      }
    ]
  },
  "isError": false
}
```

Previous: [List campaigns](https://cotlet.dev/docs/mcp/postscript/list_campaigns.md)
Next: [List keywords](https://cotlet.dev/docs/mcp/postscript/list_keywords.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.