multi-search
Execute multiple search queries simultaneously across Meilisearch indexes in a single API request to reduce network overhead and improve efficiency.
Instructions
Perform multiple searches in one request
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| searches | Yes | JSON array of search queries, each with indexUid and q fields |
Implementation Reference
- src/tools/search-tools.ts:113-145 (handler)The main handler function for the 'multi-search' tool. Parses the JSON string of search objects, validates that it's an array with indexUid in each, calls the Meilisearch /multi-search API, and returns the JSON response as text content.
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 parameter 'searches' 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 defining the input type for the multi-search handler.
interface MultiSearchParams { searches: string; } - src/tools/search-tools.ts:106-146 (registration)Full registration block for the 'multi-search' tool using server.tool(), including comment, name, description, input schema, and handler function.
// Multi-search across multiple indexes 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)Invocation of registerSearchTools which registers the search tools including 'multi-search' on the main MCP server instance.
registerSearchTools(server);