Meilisearch MCP Server

Instructions

Implementation Reference

• src/tools/document-tools.ts:201-210 (handler)

  The handler function that performs the actual deletion of the specified document from the Meilisearch index via API call.

  async ({ indexUid, documentId }: DeleteDocumentParams) => {
    try {
      const response = await apiClient.delete(`/indexes/${indexUid}/documents/${documentId}`);
      return {
        content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
      };
    } catch (error) {
      return createErrorResponse(error);
    }
  }

• src/tools/document-tools.ts:197-200 (schema)

  Zod input schema defining the parameters for the delete-document tool: indexUid and documentId.

  {
    indexUid: z.string().describe('Unique identifier of the index'),
    documentId: z.string().describe('ID of the document to delete'),
  },

• src/tools/document-tools.ts:194-211 (registration)

  The MCP server.tool registration for the delete-document tool, including name, description, schema, and handler.

  server.tool(
    'delete-document',
    'Delete a document by its ID from a Meilisearch index',
    {
      indexUid: z.string().describe('Unique identifier of the index'),
      documentId: z.string().describe('ID of the document to delete'),
    },
    async ({ indexUid, documentId }: DeleteDocumentParams) => {
      try {
        const response = await apiClient.delete(`/indexes/${indexUid}/documents/${documentId}`);
        return {
          content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
        };
      } catch (error) {
        return createErrorResponse(error);
      }
    }
  );

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

  Top-level call to register all document tools, including delete-document, on the MCP server instance.

  registerDocumentTools(server);

• src/tools/document-tools.ts:40-43 (schema)

  TypeScript interface defining the parameters for delete-document operations.

  interface DeleteDocumentParams {
    indexUid: string;
    documentId: string;
  }