Tool reference

list_activities

List Activities. List activity on the user's Substack (same rules as the WriteStack activity feed): non-dismissed items, excluding the user's own author, optional filter (all / comments / mentions).

GroupAccessMCP name
Statistics and activityRead-onlylist_activities

Description

The description the MCP server sends to the model, word for word. Its rules apply to every call.

List activity on the user's Substack (same rules as the WriteStack activity feed): non-dismissed items, excluding the user's own author, optional filter (all / comments / mentions). Results are deduped by thread, include ancestor rows when needed, and each item includes merged attachments plus reaction/restack/comment counts. Use skip and limit for pagination (max 50 per page). totalDeduped is the thread count before slicing; hasMore indicates more pages.

Arguments

ArgumentTypeRequiredDescription
filterstringNoFilter activities: all, comments, or mentions One of: "all", "comments", "mentions". Default "all".
limitnumberNoMax activities to return (default 20, max 50) Default 15.
skipnumberNoOffset for pagination Default 0.

Example call

The smallest valid request: required arguments only, with placeholder values.

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

Result

The result has structuredContent that matches this schema. The same data is also in content as JSON text.

FieldTypeRequiredDescription
activitiesobject[]Yes
countnumberYes
errorstringNo
hasMorebooleanYes
limitnumberYes
skipnumberYes
totalDedupednumberYes

Annotations

HintValue
readOnlyHinttrue
destructiveHintfalse
openWorldHintfalse

The full input and output JSON Schemas for every tool are in /mcp-tools.json.

On this page