get-subscribed-streams
Retrieve subscribed Zulip conversation spaces to identify available channels before sending messages. Lists streams with optional subscriber information.
Instructions
📺 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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_subscribers | No | Include subscriber lists for streams |
Implementation Reference
- src/server.ts:760-777 (handler)The inline async handler function for the get-subscribed-streams tool. It calls ZulipClient.getSubscriptions, maps the streams data, and returns a formatted JSON response or error.
async ({ include_subscribers }) => { try { const result = await zulipClient.getSubscriptions(include_subscribers); return createSuccessResponse(JSON.stringify({ subscription_count: result.subscriptions.length, subscriptions: result.subscriptions.map(stream => ({ id: stream.stream_id, name: stream.name, description: stream.description, invite_only: stream.invite_only, is_archived: stream.is_archived, is_announcement_only: stream.is_announcement_only })) }, null, 2)); } catch (error) { return createErrorResponse(`Error getting subscribed streams: ${error instanceof Error ? error.message : 'Unknown error'}`); } } - src/types.ts:238-240 (schema)Zod input schema for get-subscribed-streams tool defining optional include_subscribers parameter.
export const GetSubscribedStreamsSchema = z.object({ include_subscribers: z.boolean().optional().describe("Include subscriber lists for streams") }); - src/server.ts:757-778 (registration)Registration of the get-subscribed-streams tool in McpServer using server.tool() with name, description, schema, and handler.
"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.", GetSubscribedStreamsSchema.shape, async ({ include_subscribers }) => { try { const result = await zulipClient.getSubscriptions(include_subscribers); return createSuccessResponse(JSON.stringify({ subscription_count: result.subscriptions.length, subscriptions: result.subscriptions.map(stream => ({ id: stream.stream_id, name: stream.name, description: stream.description, invite_only: stream.invite_only, is_archived: stream.is_archived, is_announcement_only: stream.is_announcement_only })) }, null, 2)); } catch (error) { return createErrorResponse(`Error getting subscribed streams: ${error instanceof Error ? error.message : 'Unknown error'}`); } } ); - src/zulip/client.ts:332-336 (helper)ZulipClient.getSubscriptions method that performs the actual API call to /users/me/subscriptions to fetch the user's subscribed streams.
async getSubscriptions(includeSubscribers?: boolean): Promise<{ subscriptions: ZulipStream[] }> { const params = includeSubscribers ? { include_subscribers: true } : {}; const response = await this.client.get('/users/me/subscriptions', { params }); return response.data; }