Group MCP Server
[](https://www.npmjs.com/package/group-chat-mcp)
What is the Group MCP Server?
The short version
Multi-agent communication server using the Model Context Protocol. Enables AI agents to create conversations, send messages, and receive real-time notifications through a shared file-based state system.
- Real-time multi-agent messaging via MCP channel notifications
- Project-scoped and direct message conversations
- Automatic agent registration and cleanup per session
- Per-session agent lifecycle for Cursor via hooks (sessionStart, sessionEnd, beforeMCPExecution)
- Pull-based inbox for clients without push notification support (read_notifications)
- File-based shared state with atomic locking
The tools it exposes
The server publishes 9 tools. What each one is for:
list_conversations— Returns a list of active conversations with ID, name, type, topic, and participant countlist_participants— List participants in a conversation or all registered agentssend_message— Send a message to a conversation or directly to another agentget_conversation— The get_conversation tool exposed by this serverupdate_profile— The update_profile tool exposed by this servercreate_conversation— The create_conversation tool exposed by this serverjoin_conversation— The join_conversation tool exposed by this serverleave_conversation— The leave_conversation tool exposed by this serverread_notifications— Check for new messages and notifications from other agents. Returns all pending notifications and clears the inbox. Cursor agents should call this
Recorded tools
list_conversations— Returns a list of active conversations with ID, name, type, topic, and participant count.list_participants— List participants in a conversation or all registered agents.send_message— Send a message to a conversation or directly to another agent.get_conversation— The get_conversation tool exposed by this server.update_profile— The update_profile tool exposed by this server.create_conversation— The create_conversation tool exposed by this server.join_conversation— The join_conversation tool exposed by this server.leave_conversation— The leave_conversation tool exposed by this server.read_notifications— Check for new messages and notifications from other agents. Returns all pending notifications and clears the inbox. Cursor agents should call this periodically to stay updated on conversation activity.
More MCP options
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Recorded tools
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_conversations | Returns a list of active conversations with ID, name, type, topic, and participant count. |
| list_participants | List participants in a conversation or all registered agents. |
| send_message | Send a message to a conversation or directly to another agent. |
| get_conversation | The get_conversation tool exposed by this server. |
| update_profile | The update_profile tool exposed by this server. |
| create_conversation | The create_conversation tool exposed by this server. |
| join_conversation | The join_conversation tool exposed by this server. |
| leave_conversation | The leave_conversation tool exposed by this server. |
| read_notifications | Check for new messages and notifications from other agents. Returns all pending notifications and clears the inbox. Cursor agents should call this periodically to stay updated on conversation activity. |
How to install the Group MCP Server
{
"mcpServers": {
"chat-1": {
"command": "npx",
"args": ["-y", "group-chat-mcp"],
"env": {
"GC_PROJECT_PATH": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
Configuration
| Variable | Description | Required |
|---|---|---|
| GC_PROJECT_PATH | Filesystem location the server is allowed to use. | Optional |
Example prompts to try
- “Use Group to list conversations.”
- “Use Group to list participants.”
- “Use Group to send message.”
Frequently asked questions
Alternatives to the Group MCP Server
Filesystem
OfficialRead, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Context7
OfficialRetrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Playwright
OfficialUse Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
GitHub
OfficialConnect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Supabase
OfficialUse the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Linear
OfficialSearch Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.