FinaShopping MCP Server

Instructions

Implementation Reference

• src/tools/insurance.ts:67-79 (handler)

  Handler function that fetches rental guarantees from the API using getGuarantees() and returns a structured JSON response including the list, count, and a tip.

  async () => {
    const guarantees = await getGuarantees();
    return {
      content: [{
        type: 'text' as const,
        text: JSON.stringify({
          guarantees,
          count: guarantees.length,
          tip: 'Rental guarantees are alternatives to the traditional deposit for renting homes in Uruguay. | Las garantías de alquiler son alternativas al depósito tradicional para arrendar viviendas en Uruguay.'
        }, null, 2)
      }]
    };
  }

• src/tools/insurance.ts:62-80 (registration)

  Registers the 'search-guarantees' tool on the MCP server, including name, description, empty input schema, and inline handler.

  // Tool: search-guarantees
  server.tool(
    'search-guarantees',
    'Search available rental guarantee options in Uruguay. | Buscar opciones de garantía de alquiler disponibles en Uruguay.',
    {},
    async () => {
      const guarantees = await getGuarantees();
      return {
        content: [{
          type: 'text' as const,
          text: JSON.stringify({
            guarantees,
            count: guarantees.length,
            tip: 'Rental guarantees are alternatives to the traditional deposit for renting homes in Uruguay. | Las garantías de alquiler son alternativas al depósito tradicional para arrendar viviendas en Uruguay.'
          }, null, 2)
        }]
      };
    }
  );

• src/tools/insurance.ts:14-20 (helper)

  Helper function to fetch guarantee data from the API via fetchGuarantees().

  /**
   * Fetch guarantees from API
   */
  async function getGuarantees(): Promise<Guarantee[]> {
    const response = await fetchGuarantees();
    return response.guarantees;
  }

• src/tools/index.ts:9-9 (registration)

  Calls registerInsuranceTools to register insurance-related tools, including 'search-guarantees', as part of registering all tools.

  registerInsuranceTools(server);