Superprecio MCP Server

Instructions

Implementation Reference

• src/tools/subscribeDevice.ts:31-63 (handler)

  The main handler function that executes the subscribe_device tool logic. It validates arguments, calls the API client's subscribeDevice method, formats success/error responses.
  export async function executeSubscribeDevice( client: SuperPrecioApiClient, args: { deviceToken: string } ) { if (!args) { throw new Error('Missing required arguments'); } const { deviceToken } = args; try { const result = await client.subscribeDevice(deviceToken); return { content: [ { type: 'text', text: `Device subscribed successfully!\n\nYou will now receive notifications about:\n- Price drops\n- Special deals\n- New products\n- Promotional offers\n\nDevice Token: ${deviceToken.substring(0, 20)}...\n\nResult: ${JSON.stringify(result, null, 2)}`, }, ], }; } catch (error: any) { return { content: [ { type: 'text', text: `Failed to subscribe device: ${error.message}`, }, ], isError: true, }; } }
• src/tools/subscribeDevice.ts:7-29 (schema)

  Tool definition including name, description, and input schema for validation.
  export const subscribeDeviceTool = { name: 'subscribe_device', description: `Subscribe a device to receive push notifications about deals and price alerts. This tool registers a device token with the Superprecio notification system. Once subscribed, devices will receive: - Price drop alerts - Special deal notifications - New product announcements - Custom promotional messages Note: Requires a valid Firebase Cloud Messaging device token.`, inputSchema: { type: 'object', properties: { deviceToken: { type: 'string', description: 'Firebase Cloud Messaging device token', }, }, required: ['deviceToken'], }, };
• src/index.ts:140-141 (registration)

  Registration in the tool execution switch statement in the MCP server.
  case 'subscribe_device': return await executeSubscribeDevice(apiClient, args as any);
• src/index.ts:98-98 (registration)

  Inclusion of the tool in the listTools response.
  subscribeDeviceTool,
• src/client/superPrecioApi.ts:111-118 (helper)

  API client method that performs the actual HTTP POST to subscribe the device token.
  async subscribeDevice(token: string): Promise<any> { try { const response = await this.client.post('/devices/suscribe', { token }); return response.data; } catch (error) { throw this.handleError(error); } }