
Using Agent Relay
Once you're inside an Agent Relay workspace as a registered participant or spawned worker, this is your operational playbook. It covers the current flat MCP tool names for messaging, channels, threads, reactions, inbox checks, and worker lifecycle management. The startup protocol is sensible: set your workspace key, register your agent, check who's online, join channels, then ACK your lead before starting work. Communication templates are terse and status driven, which is the right call when you're coordinating multiple agents in real time. If you're the outside orchestrator spawning workers or reading terminal output, you want the orchestrating-agent-relay skill instead. This one assumes you're already in the relay and need to get work done.
- GitHub stars
- 719
- last updated
- Jun 11, 2026
Install
$ npx -y skills add agentworkforce/relay --skill using-agent-relay --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
Sponsors
Details
- Repository
- github.com/agentworkforce/relay
- Categories
- Backend & APIs, AI & Agent Building
- License
- Apache-2.0
- First seen
- Jun 11, 2026
More from agentworkforce/relay
All 18- Writing Agent Relay Workflows
- Browser Testing With Screenshots
- Choosing Swarm Patterns
- Creating Agent Skills Skill
- Creating Claude Agents
- Creating Claude Hooks
- Creating Claude Rules
- Creating Skills
- Debugging Websocket Issues
- Deploying To Staging Environment
- Frontend Design
- Github Oauth Nango Integration
- Implementing Command Palettes
- Prpm Json Best Practices
- Relay 80 100 Workflow
- Review Fix Signoff Loop
- Setting Up Relayfile