Documentation version: 2026-10-03.1
Canonical: https://docs.creator.gg/tools/social_replies_list.md

# social_replies_list

Read saved reply drafts and review states for this full workspace. Paginate all states before drafting; skipped, sent and uncertain comments must not be drafted again. Draft bodies are private; platform comments are read live.

## Execution

Interface: Creators MCP tool at https://mcp.creator.gg/mcp. Do not construct a REST route from the tool name. The connection selects the workspace.

Effect: read-only or navigation handoff; no marketing mutation.

## Behavior and limits

Use returned IDs, inspect the result, and preserve unrelated records/preferences.

## Example arguments

Illustrative placeholders only. Replace IDs with values from this workspace, resolve sender/content/recipients, recalculate dates, and generate a new requestId for a new action.

```json
{
  "state": "draft",
  "limit": 5
}
```

## Input schema

Generated from the current executable Creators contract. Runtime rules in Behavior and limits and the linked guide also apply; JSON Schema alone cannot express all cross-field constraints.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "accountId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "state": {
      "default": "draft",
      "type": "string",
      "enum": [
        "draft",
        "rewrite",
        "skipped",
        "sent",
        "unknown",
        "all"
      ]
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "additionalProperties": false
}
```

## Result interpretation

Results use status and message, with operation-specific data and optional link, code, nextAction, and operationId. Data may retain different list/record envelopes. A completed read or accepted send is not proof of delivery/publication. An unknown result must be reconciled. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [social](https://docs.creator.gg/guides/social.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)
- [Comments and reporting](https://docs.creator.gg/guides/social-engagement.md)
- [Writing and voice](https://docs.creator.gg/guides/social-writing.md)
- [Media preparation](https://docs.creator.gg/guides/social-media.md)
- [Scheduling](https://docs.creator.gg/guides/scheduling.md)