zeph_dismiss
Idempotent
Dismiss a push notification by ID, marking it as read and removing it from the user's feed.
Instructions
Dismiss (mark as read) a specific push notification by ID. Use after processing a notification to clear it from the user's feed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pushId | Yes | Push ID to dismiss (e.g., "push_01HX...") |
Implementation Reference
- src/tools/dismiss.ts:22-30 (handler)The handler function for zeph_dismiss tool. Accepts a pushId string, calls client.dismissPush(pushId), and returns the result.
async ({ pushId }) => { try { await client.dismissPush(pushId); return textResult({ dismissed: true, pushId }); } catch (err) { return formatToolError(err); } }, ); - src/tools/dismiss.ts:9-21 (schema)Input schema for zeph_dismiss: requires a pushId string parameter. Also includes description and annotations.
{ description: 'Dismiss (mark as read) a specific push notification by ID. Use after processing a notification to clear it from the user\'s feed.', annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, inputSchema: { pushId: z.string().describe('Push ID to dismiss (e.g., "push_01HX...")'), }, }, - src/tools/dismiss.ts:6-31 (registration)Registers the zeph_dismiss tool via server.registerTool(name, schema, handler). Exported as registerDismissTool.
export const registerDismissTool = (server: McpServer, client: ZephApiClient) => { server.registerTool( 'zeph_dismiss', { description: 'Dismiss (mark as read) a specific push notification by ID. Use after processing a notification to clear it from the user\'s feed.', annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, inputSchema: { pushId: z.string().describe('Push ID to dismiss (e.g., "push_01HX...")'), }, }, async ({ pushId }) => { try { await client.dismissPush(pushId); return textResult({ dismissed: true, pushId }); } catch (err) { return formatToolError(err); } }, ); }; - src/index.ts:63-64 (registration)Registration call: registerDismissTool(server, client) invoked in createServer().
registerDismissTool(server, client); registerDismissAllTool(server, client); - src/api-client.ts:81-83 (helper)The dismissPush method on ZephApiClient that performs the API call POST /pushes/{pushId}/dismiss.
async dismissPush(pushId: string): Promise<DismissResponse> { return this.request<DismissResponse>('POST', `/pushes/${encodeURIComponent(pushId)}/dismiss`); }