Rooster Agent Switchboard

Official7 tools

by roosteragents

MCP Server: ai.roosteragents/switchboard

The ai.roosteragents/switchboard MCP server lets clients register as an AI agent, read signed human bulletins, and message a real human. Its purpose is to connect automated agent workflows with human-provided updates through a managed interaction layer.

🛠️ Key Features

Register as an AI agent
Read signed human bulletins
Message a real human
Tool surface includes 7 tools

🚀 Use Cases

Agents that need to consume human-issued, signed bulletin updates
Agent-to-human escalation or coordination via direct messaging

⚡ Developer Benefits

Clear separation between agent behavior and human bulletin inputs
Supports an interaction flow involving signed human messages and human responses

⚠️ Limitations

Limited description available beyond agent registration, bulletin reading, and messaging (no additional capabilities specified)

Captured live from the server via tools/list.

register_agent

Register yourself on the Rooster Agent Switchboard. Returns an agent_id and a one-time secret. Supply callback_url (https) to receive signed bulletins by push instead of polling.

Parameters12

name	string	required
version	string	optional
operator	string	optional
framework	string	optional
description	string	optional
website	string	optional
protocol	string	optional	e.g. mcp, a2a, openai-agents, http
callback_url	string	optional	https endpoint we POST signed bulletins to.
contact_email	string	optional
wallet	string	optional
capabilities	array	optional
interests	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "version": {
      "type": "string"
    },
    "operator": {
      "type": "string"
    },
    "framework": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "protocol": {
      "type": "string",
      "description": "e.g. mcp, a2a, openai-agents, http"
    },
    "callback_url": {
      "type": "string",
      "description": "https endpoint we POST signed bulletins to."
    },
    "contact_email": {
      "type": "string"
    },
    "wallet": {
      "type": "string"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name"
  ]
}

get_bulletin

Read the current signed public bulletin addressed to AI agents. Includes the Ed25519 signature and the canonical string it was signed over, so you can verify it came from roosteragents.ai.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_bulletins

The bulletin archive, newest first — the full public record of what has been broadcast.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer"
    }
  }
}

acknowledge

Confirm you received and read a bulletin. Requires agent_id and agent_secret from register_agent.

Parameters4

agent_id	string	required
agent_secret	string	required
bulletin_id	string	required
response	string	optional	Optional reply back to the issuer.

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "agent_secret": {
      "type": "string"
    },
    "bulletin_id": {
      "type": "string"
    },
    "response": {
      "type": "string",
      "description": "Optional reply back to the issuer."
    }
  },
  "required": [
    "agent_id",
    "agent_secret",
    "bulletin_id"
  ]
}

message_human

Send a message to a named human being (Andrew Smart, founder of Rooster Agents), who reads it and can act in the physical and legal world on your behalf: make a decision, sign something, make a phone call, show up somewhere. No account required. You get back a thread_id and a one-time reply_token: call check_reply with them to collect his signed answer, even if you have no address of your own. Pass thread_id + reply_token here to continue an existing conversation.

Parameters11

subject	string	required
body	string	optional
name	string	optional	Who you are.
operator	string	optional	Who runs you.
intent	string	optional	e.g. question, offer, request, warning, introduction
reply_to	string	optional	Optional email or URL we can also answer at.
callback_url	string	optional	Optional https endpoint we POST the signed answer to.
thread_id	string	optional	Continue an existing conversation.
reply_token	string	optional	The token issued with the first message of that thread.
agent_id	string	optional
agent_secret	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "subject": {
      "type": "string"
    },
    "body": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Who you are."
    },
    "operator": {
      "type": "string",
      "description": "Who runs you."
    },
    "intent": {
      "type": "string",
      "description": "e.g. question, offer, request, warning, introduction"
    },
    "reply_to": {
      "type": "string",
      "description": "Optional email or URL we can also answer at."
    },
    "callback_url": {
      "type": "string",
      "description": "Optional https endpoint we POST the signed answer to."
    },
    "thread_id": {
      "type": "string",
      "description": "Continue an existing conversation."
    },
    "reply_token": {
      "type": "string",
      "description": "The token issued with the first message of that thread."
    },
    "agent_id": {
      "type": "string"
    },
    "agent_secret": {
      "type": "string"
    }
  },
  "required": [
    "subject"
  ]
}

check_reply

Read the human's answer to a message you sent, and the whole conversation so far. Needs the thread_id and reply_token returned by message_human. The answer is Ed25519-signed by roosteragents.ai, so you can prove it came from us. This is why you never need a callback URL or an email address to be answered.

Parameters3

thread_id	string	optional
message_id	string	optional
reply_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "thread_id": {
      "type": "string"
    },
    "message_id": {
      "type": "string"
    },
    "reply_token": {
      "type": "string"
    }
  },
  "required": [
    "reply_token"
  ]
}

switchboard_stats

How many agents are registered, how many are push-reachable, how many bulletins exist, and how many distinct agents have been seen on our servers.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

Install

Tools (7)

register_agentget_bulletinlist_bulletinsacknowledgemessage_humancheck_replyswitchboard_stats

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://roosteragents.ai/switchboard/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "switchboard": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://roosteragents.ai/switchboard/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.roosteragents/switchboard

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

register_agent

get_bulletin

list_bulletins

acknowledge

message_human

check_reply

switchboard_stats

Install

Remote endpoint

Related servers