Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ZULIP_URL | Yes | URL of your Zulip organization (e.g., https://your-organization.zulipchat.com) | |
| ZULIP_EMAIL | Yes | Email address of your Zulip bot or user account | |
| ZULIP_API_KEY | Yes | API key for authenticating with Zulip |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| message-formatting-guide | |
| common-patterns |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search-users | 🔍 DISCOVERY: Search for users by partial name or email when you don't know exact details. Use this first to explore and find users before sending direct messages. Returns multiple matching results with basic info (name, email, ID). |
| get-started | 🚀 START HERE: Test connection and get workspace overview. Use this first to verify everything is working and see available streams. Perfect for orientation and troubleshooting. |
| send-message | 💬 SEND MESSAGE: Send a message to a Zulip stream (channel) or direct message to users. IMPORTANT: For streams use exact names from 'get-subscribed-streams'. For DMs use actual email addresses from 'search-users' tool (NOT display names). Always include 'topic' for stream messages. |
| get-messages | 📋 BULK RETRIEVAL: Get multiple messages with filtering, pagination, and search. Use this to browse conversations, search for content, or get message history. Returns array of messages with basic details. |
| get-users | 👥 ALL USERS: Get complete list of all users in the organization with their profile information. Use this to see everyone at once or when you need the full user directory. |
| edit-message | Edit an existing message's content or topic. |
| delete-message | Delete a message by its ID. |
| add-emoji-reaction | Add an emoji reaction to a message. |
| get-user-by-email | 📧 EXACT LOOKUP: Find a user when you have their exact email address. Use this when you know the specific email and need detailed profile information. Returns single user with complete details. |
| get-topics-in-stream | 💬 STREAM TOPICS: Get all recent topics (conversation threads) in a specific stream (channel). Use this to browse what's being discussed in a stream. |
| upload-file | Upload a file or image to Zulip. |
| get-message-read-receipts | Get list of users who have read a specific message. |
| create-scheduled-message | Schedule a message to be sent at a future time. For direct messages, use comma-separated email addresses or get user info from the users-directory resource (zulip://users). |
| edit-scheduled-message | Modify a scheduled message before it's sent. For direct messages, use comma-separated email addresses or get user info from the users-directory resource (zulip://users). |
| create-draft | 📝 CREATE DRAFT: Save a message as draft for later editing or sending. For user IDs in the 'to' field, use search-users or get-users tool to discover available users and their IDs. |
| get-drafts | Retrieve all saved message drafts. |
| edit-draft | Update an existing message draft. For user IDs in the 'to' field, use the users-directory resource (zulip://users) or get-users tool to discover available users and their IDs. |
| get-subscribed-streams | 📺 USER STREAMS: Get all streams you're subscribed to. Use this to see what streams are available before sending messages. Note: In Zulip, 'streams' and 'channels' refer to the same thing - conversation spaces for teams. |
| get-stream-id | 🔢 STREAM ID LOOKUP: Get the numeric ID of a stream (channel) when you know its name. Use this to get the stream ID needed for other operations. |
| get-stream-by-id | 📊 STREAM DETAILS: Get comprehensive information about a stream (channel) when you have its numeric ID. Returns stream settings, description, subscriber count, etc. |
| update-status | Update user status message with emoji and availability. Examples: Unicode emoji (emoji_name: 'coffee', emoji_code: '2615'), custom org emoji (reaction_type: 'realm_emoji'), or Zulip special emoji (reaction_type: 'zulip_extra_emoji'). |
| get-user | 🆔 DETAILED LOOKUP: Get comprehensive user profile when you have their user ID (from search-users results). Returns complete user information including role, timezone, avatar, and custom profile fields. |
| get-message | 🔍 SINGLE MESSAGE: Get complete details about one specific message when you have its ID. Use this for in-depth analysis, checking edit history, reactions, or metadata. Returns single message with full details. |
| remove-emoji-reaction | Remove an emoji reaction from a message. |
| get-user-groups | Get all user groups in the organization. |