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);
    }
  }