Skip to content

mute_user

Mute a user to hide their content from your feeds and notifications without them knowing.

Authentication

Required: Yes (Private tool)

Parameters

actor (required)

  • Type: string
  • Description: User identifier (DID or handle) to mute

Response

Tool results are returned as stringified JSON text. The illustrative shape is:

typescript
{
  success: boolean;
  message: string;
  mutedUser: {
    actor: string;   // echoes the actor you passed in
    did?: string;
  };
}

Examples

Mute a User

json
{
  "actor": "spammer.bsky.social"
}

Response (illustrative):

json
{
  "success": true,
  "message": "User spammer.bsky.social has been muted. Their content will no longer appear in your feeds.",
  "mutedUser": {
    "actor": "spammer.bsky.social"
  }
}

What Muting Does

  • Posts, replies, and reposts from the muted user are hidden from your feeds.
  • Notifications from the muted user are suppressed.
  • You remain following the user (if you were), and the user can still see and interact with your content. Muting is invisible to them.

Error Handling

An actor that is neither a DID nor a handle raises a VALIDATION_ERROR before any network call. Muting is idempotent on the server, so re-muting an already-muted user succeeds. Other failures surface as the underlying AT Protocol error.

Mute vs Block

  • Mute: soft filter, user unaware, reversible.
  • Block: hard barrier, user may notice, more severe.

See Also