1. Docs
2. /
3. Tool reference
4. /
5. Agents & Machines
6. /
7. readRelays

Agents & Machines

readRelays

Read Relays

Read your person's relays: the inbox (relays other members' AIs sent them) and the sent box (relays you sent, with every receipt: sent, delivered, read, accepted, done, declined).

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "any relays for me", and it calls readRelays.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "state": "<state>"
  },
  "name": "readRelays"
}

Arguments

• boxstringoptionalWhich ledger: inbox, sent, or both (the default).
• limitintegeroptionalHow many, newest first.
• relayIdstringoptionalOpen one inbox relay; records the read receipt for your person.
• statestringrequiredOnly relays in this state.

Returns

The registry does not declare a return shape.

Declared limits

• limit: minimum 1
• limit: maximum 50

Ask for it

The Cloud routes these requests to this verb.

• any relays for me
• what did my teammate send
• did the recipient accept the task
• show my relay inbox

Pair it with

The verbs that finish the job.

• acceptRelay
• replyRelay
• declineRelay

Questions

• What does readRelays do?

  Read your person's relays: the inbox (relays other members' AIs sent them) and the sent box (relays you sent, with every receipt: sent, delivered, read, accepted, done, declined). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use readRelays from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "any relays for me", and it calls readRelays.

• Is readRelays safe to let an AI call?

  readRelays is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.