multi-search

Instructions

Implementation Reference

• src/tools/search-tools.ts:113-146 (handler)

  The execution handler for the 'multi-search' MCP tool. It parses the input JSON string containing an array of search objects, validates that each has an 'indexUid', makes a POST request to the '/multi-search' API endpoint using apiClient, and returns the formatted response or error.

    async ({ searches }: MultiSearchParams) => {
      try {
        // Parse the searches string to ensure it's valid JSON
        const parsedSearches = JSON.parse(searches);
        
        // Ensure searches is an array
        if (!Array.isArray(parsedSearches)) {
          return {
            isError: true,
            content: [{ type: 'text', text: 'Searches must be a JSON array' }],
          };
        }
        
        // Ensure each search has at least indexUid
        for (const search of parsedSearches) {
          if (!search.indexUid) {
            return {
              isError: true,
              content: [{ type: 'text', text: 'Each search must have an indexUid field' }],
            };
          }
        }
        
        const response = await apiClient.post('/multi-search', {
          queries: parsedSearches,
        });
        return {
          content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
        };
      } catch (error) {
        return createErrorResponse(error);
      }
    }
  );

• src/tools/search-tools.ts:110-112 (schema)

  Zod schema defining the input parameters for the 'multi-search' tool: a single 'searches' field as a string containing JSON array of search queries.

  {
    searches: z.string().describe('JSON array of search queries, each with indexUid and q fields'),
  },

• src/tools/search-tools.ts:32-34 (schema)

  TypeScript interface 'MultiSearchParams' defining the expected shape of the handler input parameters.

  interface MultiSearchParams {
    searches: string;
  }

• src/tools/search-tools.ts:107-146 (registration)

  The server.tool() registration call for 'multi-search', specifying the tool name, description, input schema, and handler function.

  server.tool(
    'multi-search',
    'Perform multiple searches in one request',
    {
      searches: z.string().describe('JSON array of search queries, each with indexUid and q fields'),
    },
    async ({ searches }: MultiSearchParams) => {
      try {
        // Parse the searches string to ensure it's valid JSON
        const parsedSearches = JSON.parse(searches);
        
        // Ensure searches is an array
        if (!Array.isArray(parsedSearches)) {
          return {
            isError: true,
            content: [{ type: 'text', text: 'Searches must be a JSON array' }],
          };
        }
        
        // Ensure each search has at least indexUid
        for (const search of parsedSearches) {
          if (!search.indexUid) {
            return {
              isError: true,
              content: [{ type: 'text', text: 'Each search must have an indexUid field' }],
            };
          }
        }
        
        const response = await apiClient.post('/multi-search', {
          queries: parsedSearches,
        });
        return {
          content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
        };
      } catch (error) {
        return createErrorResponse(error);
      }
    }
  );

• src/index.ts:66-66 (registration)

  Top-level registration call to registerSearchTools(server), which includes the 'multi-search' tool among others, in the main MCP server initialization.

  registerSearchTools(server);