
Using Agent Relay
Use when you are a registered relay agent (a spawned worker, or a lead that called...
Install
npx skills add AgentWorkforce/relay --skill using-agent-relay -g -a claude-code -y- Repository
- AgentWorkforce/relay1.1k
- Category
- AI and agents
- Updated
- 3d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 1,953 tokens
- Runs scripts
- No, instructions only
What it does
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.
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, orregister_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 |

