Superprecio MCP Server

Instructions

Implementation Reference

• src/tools/sendNotification.ts:42-105 (handler)

  Core handler function that implements the send_notification tool logic. Handles input validation, conditional API calls for targeted or broadcast notifications, response formatting, and error handling.
  export async function executeSendNotification( client: SuperPrecioApiClient, args: { title: string; message: string; deviceToken?: string; data?: Record<string, any>; } ) { if (!args) { throw new Error('Missing required arguments'); } const { title, message, deviceToken, data } = args; try { let result; if (deviceToken) { // Send to specific device result = await client.sendNotification({ token: deviceToken, title, body: message, data, }); return { content: [ { type: 'text', text: `Notification sent successfully to device!\n\nTitle: ${title}\nMessage: ${message}`, }, ], }; } else { // Broadcast to all devices result = await client.broadcastNotification({ title, body: message, data, }); return { content: [ { type: 'text', text: `Notification broadcast successfully to all devices!\n\nTitle: ${title}\nMessage: ${message}\n\nResult: ${JSON.stringify(result, null, 2)}`, }, ], }; } } catch (error: any) { return { content: [ { type: 'text', text: `Failed to send notification: ${error.message}`, }, ], isError: true, }; } }
• src/tools/sendNotification.ts:7-40 (schema)

  Defines the tool metadata, description, and input schema for validation of send_notification parameters.
  export const sendNotificationTool = { name: 'send_notification', description: `Send a push notification to a specific device or broadcast to all subscribed devices. This tool can: - Send personalized notifications to specific devices - Broadcast alerts to all users - Include custom data (like product links, images, etc.) - Notify about price drops, deals, or important updates Note: Requires Firebase Cloud Messaging setup on the Superprecio server.`, inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'Notification title', }, message: { type: 'string', description: 'Notification body/message', }, deviceToken: { type: 'string', description: 'Optional: specific device token to send to. If not provided, broadcasts to all devices.', }, data: { type: 'object', description: 'Optional: additional data to include (e.g., product URL, image URL)', }, }, required: ['title', 'message'], }, };
• src/index.ts:97-97 (registration)

  Registration of sendNotificationTool in the array of tools returned by the MCP listTools handler.
  sendNotificationTool,
• src/index.ts:137-138 (registration)

  Dispatch/execution routing for the send_notification tool in the MCP callTool request handler.
  case 'send_notification': return await executeSendNotification(apiClient, args as any);
• src/client/superPrecioApi.ts:123-135 (helper)

  Underlying API client method for sending notifications to a specific device token, called by the tool handler.
  async sendNotification(data: { token: string; title: string; body: string; data?: Record<string, any>; }): Promise<any> { try { const response = await this.client.post('/notifications/send', data); return response.data; } catch (error) { throw this.handleError(error); } }