Walrus MCP Server

Instructions

Implementation Reference

• src/index.ts:179-190 (handler)

  The tool handler for 'delete_blob' which parses input arguments using DeleteBlobSchema and delegates to walrusClient.deleteBlob(blobId), returning the result as JSON text.

  case 'delete_blob': {
    const { blobId } = DeleteBlobSchema.parse(args);
    const result = await walrusClient.deleteBlob(blobId);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:43-45 (schema)

  Zod schema for validating the input parameters of the delete_blob tool (requires blobId string).

  const DeleteBlobSchema = z.object({
    blobId: z.string().describe('The blob ID to delete'),
  });

• src/index.ts:102-115 (registration)

  Registration of the 'delete_blob' tool in the list_tools response, including name, description, and input schema.

  {
    name: 'delete_blob',
    description: 'Delete a blob from Walrus storage',
    inputSchema: {
      type: 'object',
      properties: {
        blobId: {
          type: 'string',
          description: 'The blob ID to delete',
        },
      },
      required: ['blobId'],
    },
  },

• src/walrus-client.ts:161-167 (helper)

  Implementation of deleteBlob method in WalrusClient class. Currently a stub that always returns failure since Walrus does not support manual blob deletion.

  async deleteBlob(blobId: string): Promise<{ success: boolean; message: string }> {
    // Note: Walrus blobs cannot be deleted once stored - they expire based on their epoch settings
    return {
      success: false,
      message: 'Walrus blobs cannot be manually deleted. They will expire automatically based on their storage epochs.',
    };
  }