MCP Tools
subscription_list
List all subscriptions in the workspace.
List all subscriptions in the workspace. Shows creator info, sync status, and content counts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by: active, paused, all (default: all) |
limit | number | No | Items per page (1-100, default: 50) |
offset | number | No | Items to skip (default: 0) |
Example
Prompt
Show me all the creators I'm subscribed toResponse
{
"subscriptions": [
{
"id": "sub_abc123",
"status": "active",
"dailyUpdates": true,
"createdAt": "2024-02-01T09: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z",
"lastSyncAt": "2024-03-15T06: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z",
"creator": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"displayName": "Naval",
"avatarUrl": "https:<COMMENT>//pbs.twimg.com/..."</COMMENT>
},
"stats": {
"contentCount": 450,
"pendingDigest": 12
}
},
{
"id": "sub_def456",
"status": "paused",
"dailyUpdates": false,
"createdAt": "2024-01-15T10: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z",
"lastSyncAt": "2024-02-28T06: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z",
"creator": {
"id": "660f9500-f39c-52e5-b827-557766550000",
"platform": "linkedin",
"handle": "sahilbloom",
"displayName": "Sahil Bloom",
"avatarUrl": "https:<COMMENT>//media.licdn.com/..."</COMMENT>
},
"stats": {
"contentCount": 120,
"pendingDigest": 0
}
}
],
"pagination": {
"total": 5,
"limit": 50,
"offset": 0,
"hasMore": false
}
}Response Fields
subscription
| Field | Type | Description |
|---|---|---|
id | string | Subscription UUID |
status | string | active or paused |
dailyUpdates | boolean | Daily sync enabled |
lastSyncAt | string | Last content fetch timestamp |
creator | object | Creator details |
stats | object | Content statistics |
stats
| Field | Description |
|---|---|
contentCount | Total posts fetched from this creator |
pendingDigest | Posts waiting to be reviewed |
Use Cases
- Review all creators you're following
- Find subscriptions that need attention (paused or behind)
- Check content counts per creator