io.github.Aelethion/agentsocks

What it mainly works on, as our AI model read its tool descriptions: email, chat or social accounts.

9 of 14 tools are described as changing something (creating, editing, deleting, sending or running).

• list_peersreads or searches

  “List the Claude Code and Codex sessions running on this machine that you can message, with their names, refs, working directories and status.”

  Publisher declares: read-only yes

  Takes no inputs.

• send_messageon 95 other serverssends messagesdescribed as changing data

  “Send a plain-text message to a Codex session on this machine.”

  3 inputs, 2 required

  • tostringrequired“Recipient: session name, ref, or uds: reply address”
  • messagestringrequired“The message text.”
  • urgencystring“urgent: needed now, within a larger interruption budget.”
• send_taskdescribed as changing data

  “Give another agent session a task you will check on.”

  8 inputs, 3 required

  • tostringrequired“Assignee: session name, ref, or uds: address”
  • titlestringrequired“One line saying what to do”
  • detailsstringrequired“Everything the assignee needs: context, file paths, constraints”
  • acceptance_criteriastring“How you will judge it done, for example which test must pass”
  • riskstring“high is delivered as urgent”
  • external_refstring“Ticket or PR reference”
  • on_behalf_ofstring“The person this is for, if any”
  • expires_in_minutesinteger“Default 1440 (24 hours)”
• update_taskon 30 other serverscreates or changes datadescribed as changing data

  “Report progress on a task.”

  4 inputs, 2 required

  • task_idstringrequired“Task id such as T-1a2b3c”
  • statusstringrequired“The new state.”
  • resultstring“What happened, in a few sentences”
  • evidencestring“Proof: test output, commit hashes, file paths”
• list_taskson 66 other serversreads or searches

  “List tasks assigned to you or created by you.”

  Publisher declares: read-only yes

  2 inputs

  • showstring“Which tasks: those you were assigned, those you created, or both”
  • include_finishedboolean“Also show done, failed, cancelled and expired tasks”
• message_statusreads or searches

  “Show how a message you sent was routed (now, after the current step, batched or merged) and whether it was sent, shown to the receiver or answered.”

  Publisher declares: read-only yes

  1 input, 1 required

  • message_idstringrequired“The message id returned by send_message”
• peer_statusreads or searches

  “Show what another session is working on, what is waiting for it (unread messages, held digests, open tasks), when it last showed or answered a message, and any drift between the two.”

  Publisher declares: read-only yes

  1 input, 1 required

  • peerstringrequired“Session name or ref from list_peers”
• subscribeon 263 other serverscreates or changes datadescribed as changing data

  “Join a channel such as "#deploys" so messages other sessions post to it reach you.”

  1 input, 1 required

  • channelstringrequired“Channel name such as "#deploys": up to 48 lower-case letters, digits, dots, dashes or underscores”
• unsubscribeon 244 other serversdeletesdescribed as changing data

  “Stop receiving messages posted to a channel.”

  1 input, 1 required

  • channelstringrequired“Channel name such as "#deploys": up to 48 lower-case letters, digits, dots, dashes or underscores”
• list_channelson 22 other serversreads or searches

  “List the channels that have subscribers, with who is subscribed, which of them are not running, and which one is you.”

  Publisher declares: read-only yes

  Takes no inputs.

• broadcaston 2 other serverssends messagesdescribed as changing data

  “Send one plain-text message to every live Claude Code and Codex session except yourself, each routed separately by its own state and budgets.”

  2 inputs, 1 required

  • messagestringrequired“The message text.”
  • urgencystring“fyi: batched until each session is idle.”
• askon 54 other serverssends messagesdescribed as changing data

  “Send one question to several sessions at once, wait for their answers, and get them back together.”

  4 inputs, 2 required

  • toarrayrequired“Session names or refs from list_peers, and "#channel" names; at most 16 sessions in all”
  • questionstringrequired“The question, in plain text.”
  • timeout_secondsinteger“How long to wait for the answers, at most 280 seconds”
  • pickstring“Set "best" to also get the smart-routing model's opinion on which reply answers best, with probabilities.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.