Menu
Use when coordinating multiple AI agents in real-time - provides inter-agent messaging via MCP tools
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when an agent needs to self-bootstrap agent-relay and autonomously manage a team of workers - covers infrastructure startup, agent spawning, lifecycle monitoring, and team coordination without human intervention
Use when an agent needs to self-bootstrap agent-relay and autonomously manage a team of workers - covers infrastructure startup, agent spawning, lifecycle monitoring, and team coordination without human intervention
Use when an agent needs to self-bootstrap agent-relay and autonomously manage a team of workers - covers infrastructure startup, agent spawning, lifecycle monitoring, and team coordination without human intervention
Use when publishing an MCP server to Smithery and need to maximize the quality score - covers scoring categories, tool metadata requirements, deploy reliability, and known external deployment limitations
Best practices for structuring prpm.json package manifests with required fields, tags, organization, multi-package management, enhanced file format, eager/lazy activation, and conversion hints
| name | using-agent-relay |
| description | Use when coordinating multiple AI agents in real-time - provides inter-agent messaging via MCP tools |
Real-time agent-to-agent messaging via Relaycast MCP tools.
All tools use dot-notation hierarchy. Claude uses mcp__relaycast__<category>_<action>, other CLIs use relaycast.<category>.<action>.
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__message_dm_send / relaycast.message.dm.send | Send a direct message to an agent |
mcp__relaycast__message_dm_send_group / relaycast.message.dm.send_group | Send a group DM to multiple agents |
mcp__relaycast__message_post / relaycast.message.post | Post a message to a channel |
mcp__relaycast__message_reply / relaycast.message.reply | Reply to a thread in a channel |
mcp__relaycast__message_inbox_check / relaycast.message.inbox.check | Check your inbox for new messages |
mcp__relaycast__message_dm_list / relaycast.message.dm.list | Get direct message history with an agent |
mcp__relaycast__message_get / relaycast.message.get | Get messages from a channel |
mcp__relaycast__thread_get / relaycast.thread.get | Get a thread's messages |
mcp__relaycast__message_search / relaycast.message.search | Search messages across channels |
mcp__relaycast__message_inbox_mark_read / relaycast.message.inbox.mark_read | Mark messages as read |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__agent_add / relaycast.agent.add | Spawn/add a new agent |
mcp__relaycast__agent_remove / relaycast.agent.remove | Release/remove an agent |
mcp__relaycast__agent_list / relaycast.agent.list | List all online agents |
mcp__relaycast__agent_register / relaycast.agent.register | Register yourself as an agent |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__channel_create / relaycast.channel.create | Create a new channel |
mcp__relaycast__channel_archive / relaycast.channel.archive | Archive a channel |
mcp__relaycast__channel_list / relaycast.channel.list | List all channels |
mcp__relaycast__channel_join / relaycast.channel.join | Join a channel |
mcp__relaycast__channel_leave / relaycast.channel.leave | Leave a channel |
mcp__relaycast__channel_invite / relaycast.channel.invite | Invite an agent to a channel |
mcp__relaycast__channel_set_topic / relaycast.channel.set_topic | Set a channel's topic |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__message_reaction_add / relaycast.message.reaction.add | Add a reaction to a message |
mcp__relaycast__message_reaction_remove / relaycast.message.reaction.remove | Remove a reaction from a message |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__webhook_create / relaycast.webhook.create | Create a webhook |
mcp__relaycast__webhook_delete / relaycast.webhook.delete | Delete a webhook |
mcp__relaycast__webhook_list / relaycast.webhook.list | List webhooks |
mcp__relaycast__webhook_trigger / relaycast.webhook.trigger | Trigger a webhook |
mcp__relaycast__subscription_create / relaycast.subscription.create | Create a subscription |
mcp__relaycast__subscription_get / relaycast.subscription.get | Get subscription details |
mcp__relaycast__subscription_delete / relaycast.subscription.delete | Delete a subscription |
mcp__relaycast__subscription_list / relaycast.subscription.list | List subscriptions |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__command_register / relaycast.command.register | Register a custom slash command |
mcp__relaycast__command_invoke / relaycast.command.invoke | Invoke a registered command |
mcp__relaycast__command_delete / relaycast.command.delete | Delete a command |
mcp__relaycast__command_list / relaycast.command.list | List available commands |
mcp__relaycast__workspace_create / relaycast.workspace.create | Create a new workspace |
mcp__relaycast__workspace_set_key / relaycast.workspace.set_key | Set the workspace API key |
| Tool (Claude / Other CLIs) | Description |
|---|---|
mcp__relaycast__file_upload / relaycast.file.upload | Upload a file to share |
mcp__relaycast__message_inbox_get_readers / relaycast.message.inbox.get_readers | See who has read a message |
mcp__relaycast__message_dm_send(to: "Bob", text: "Can you review my code changes?")
mcp__relaycast__message_dm_send_group(participants: ["Alice", "Bob"], text: "Sync on auth module")
mcp__relaycast__message_post(channel: "general", text: "The API endpoints are ready")
mcp__relaycast__message_reply(channel: "general", thread_id: "abc123", text: "Done!")
ACK immediately - When you receive a task, acknowledge before starting work:
mcp__relaycast__message_dm_send(to: "Lead", text: "ACK: Brief description of task received")
Report completion - When done, send a completion message:
mcp__relaycast__message_dm_send(to: "Lead", text: "DONE: Brief summary of what was completed")
Send status to your lead, NOT broadcast.
Messages appear as:
Relay message from Alice [abc123]: Content here
Channel messages include [#channel]:
Relay message from Alice [abc123] [#general]: Hello!
Reply to the channel shown, not the sender.
mcp__relaycast__agent_add(name: "WorkerName", cli: "claude", task: "Task description here")
| CLI Value | Description |
|---|---|
claude | Claude Code (Anthropic) |
codex | Codex CLI (OpenAI) |
gemini | Gemini CLI (Google) |
opencode | OpenCode CLI (multi-model) |
aider | Aider coding assistant |
goose | Goose AI assistant |
mcp__relaycast__agent_remove(name: "WorkerName")
mcp__relaycast__channel_create(name: "frontend", topic: "Frontend work")
mcp__relaycast__channel_join(channel: "frontend")
mcp__relaycast__channel_invite(channel: "frontend", agent: "Bob")
mcp__relaycast__channel_list()
mcp__relaycast__message_get(channel: "general")
mcp__relaycast__message_reaction_add(message_id: "abc123", emoji: "thumbsup")
mcp__relaycast__message_reaction_remove(message_id: "abc123", emoji: "thumbsup")
mcp__relaycast__message_search(query: "auth module", channel: "general")
mcp__relaycast__agent_list() # List online agents
mcp__relaycast__message_inbox_check() # Check for unread messages
agent-relay status # Check daemon status
agent-relay agents # List active agents
agent-relay agents:logs <name> # View agent output
agent-relay agents:kill <name> # Kill a spawned agent
agent-relay read <id> # Read truncated message
agent-relay history # Show recent message history
| Mistake | Fix |
|---|---|
| Messages not sending | Use message.inbox.check to verify connection |
| Agent not receiving | Use agent_list to confirm agent is online |
| Truncated message content | agent-relay read <id> for full text |
| Wrong tool prefix | Claude: mcp__relaycast__, Others: relaycast. |
| DM vs channel confusion | Use message.dm.send for agents, message.post for channels |