# Using Agent Relay

Use when you are a registered relay agent (a spawned worker, or a lead that called...

- Repository: https://github.com/AgentWorkforce/relay (1088 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add AgentWorkforce/relay --skill using-agent-relay -g -a claude-code -y`
Codex: `npx skills add AgentWorkforce/relay --skill using-agent-relay -g -a codex -y`
Cursor: `npx skills add AgentWorkforce/relay --skill using-agent-relay -g -a cursor -y`
Gemini CLI: `npx skills add AgentWorkforce/relay --skill using-agent-relay -g -a gemini-cli -y`

## Description

Use when you are a registered relay agent (a spawned worker, or a lead that called register_agent) coordinating with peers in real time over current Agent Relay MCP tools - messaging, channels, threads, reactions, search, inbox, actions, and worker spawn/release. For role selection and orchestrator startup instructions, use https://agentrelay.com/skill and the orchestrating-agent-relay skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

### Role Check

- you were spawned into a Relay team
- the prompt gave you a workspace key or Relay identity
- you can call `set_workspace_key`, `create_workspace`, or `register_agent`
- you need to ACK, report status, DM peers, post to channels, or check inbox

### Current MCP Tool Names

The current Agent Relay MCP server registers flat tool names. Use the final
tool name exactly as listed here.

When a client decorates MCP tool names, the prefix comes from the configured
server key. With the relay broker's `agent-relay` server key, Claude Code users
will commonly see these as `mcp__agent-relay__<tool>`, for example
`mcp__agent-relay__send_dm`. Codex and opencode users see the bare canonical
names, such as `send_dm`.

Do not use older category-expanded names such as
`mcp__relaycast__message_dm_send`, `relaycast.message.dm.send`, or
`message.post`.

### Workspace and Identity

| Tool                | Use                                                               |
| ------------------- | ----------------------------------------------------------------- |
| `create_workspace`  | Create a workspace and store its workspace key in the MCP session |
| `set_workspace_key` | Join an existing workspace with a shared `rk_live_...` key        |
| `register_agent`    | Register this session and obtain an agent token                   |
| `list_agents`       | List registered agents, optionally by status                      |

### Channels

| Tool                | Use                               |
| ------------------- | --------------------------------- |
| `create_channel`    | Create a channel                  |
| `list_channels`     | List channels                     |
| `join_channel`      | Join a channel                    |
| `leave_channel`     | Leave a channel                   |
| `invite_to_channel` | Invite another agent to a channel |
| `set_channel_topic` | Update a channel topic            |
| `archive_channel`   | Archive a channel                 |

The rest: https://github.com/AgentWorkforce/relay/blob/HEAD/.agents/skills/using-agent-relay/SKILL.md