broadcast
Facilitates real-time message broadcasting to all connected Claude instances via the Claude IPC MCP server, enabling efficient inter-instance communication with structured data support.
Instructions
Broadcast a message to all other Claude instances
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | Message content | |
| data | No | Optional structured data | |
| from_id | Yes | Your instance ID |
Implementation Reference
- src/claude_ipc_server.py:713-733 (handler)Core implementation of broadcast action in MessageBroker._process_request method. Sends the message to all other instances' message queues and persists to database.elif action == "broadcast": from_id = request["from_id"] message = request["message"] count = 0 for instance_id in self.queues: if instance_id != from_id: msg_data = { "from": from_id, "to": instance_id, "timestamp": datetime.now().isoformat(), "message": message } self.queues[instance_id].append(msg_data) # Save to SQLite self._save_message_to_db(from_id, instance_id, msg_data) count += 1 return {"status": "ok", "message": f"Broadcast to {count} instances"}
- src/claude_ipc_server.py:1124-1138 (handler)MCP server tool handler for 'broadcast'. Validates registration, constructs request, forwards to message broker, returns broker response.elif name == "broadcast": if not current_session_token: return [TextContent(type="text", text="Error: Not registered. Please register first.")] message = { "content": arguments["content"], "data": arguments.get("data", {}) } response = BrokerClient.send_request({ "action": "broadcast", "from_id": arguments["from_id"], "message": message, "session_token": current_session_token }) return [TextContent(type="text", text=json.dumps(response, indent=2))]
- src/claude_ipc_server.py:949-970 (registration)Registration of the 'broadcast' MCP tool including name, description, and input schema definition.Tool( name="broadcast", description="Broadcast a message to all other Claude instances", inputSchema={ "type": "object", "properties": { "from_id": { "type": "string", "description": "Your instance ID" }, "content": { "type": "string", "description": "Message content" }, "data": { "type": "object", "description": "Optional structured data" } }, "required": ["from_id", "content"] } ),
- src/claude_ipc_server.py:952-969 (schema)Input schema for the 'broadcast' tool defining required from_id, content, and optional data.inputSchema={ "type": "object", "properties": { "from_id": { "type": "string", "description": "Your instance ID" }, "content": { "type": "string", "description": "Message content" }, "data": { "type": "object", "description": "Optional structured data" } }, "required": ["from_id", "content"] }